SimpleTool Server Docs home page
Search...
βK
getsimpletool/simpletool-server
getsimpletool/simpletool-server
Search...
Navigation
Getting Started
π Introduction
Guides
Getting Started
π Introduction
π Quickstart
Configuration
π©Ί API Reference
βοΈ Environment Variables
Integrations
πͺοΈ Windsurf
On this page
π€ What is SimpleTool Server?
β¨ Key Features
π What we have nowβ¦
π Working onβ¦
Getting Started
π Introduction
Welcome to the SimpleTool Server documentation.
β
π€ What is SimpleTool Server?
SimpleTool Server is a lightweight, asynchronous API platform for running and managing MCP tools in isolated, secure environments.
β
β¨ Key Features
β¨ Local Docker container β your own local Docker container with a single SSE-MCP connection
β‘ Support for any MCP tool launched via
uvx
or
npx
π Dynamic tool loading and filtering (whitelist/blacklist)
π Access to MCP tools via SSE, Swagger REST, and OpenAPI.json (compatible with OpenWebUI)
π³ Tool isolation β each tool runs in its own thread
ποΈ JSON-based configuration β easy to edit and portable
π§βπ» Ability to launch your own MCP server with custom ENV parameters
π‘οΈ Bearer admin hack β simple admin authorization (ideal for testing and quick changes)
π Async FastAPI Python server with full type hints for code clarity and safety
β PyTest β fast and easy verification of changes on a running server
β
π What we have nowβ¦
π Docker container built on Debian 13 with FastAPI/Python 3.13 server
β‘ Support for any MCP tool launched via
uvx
or
npx
π Access to MCP tools via SSE, Swagger REST, and OpenAPI.json (OpenWebUI compatible)
π SupervisorD controlled by ENV allows running SSHD + Xfce + noVNC (desktop via web/port 6901, ~400MB)
π Dynamic tool loading and filtering from MCP server (whitelist/blacklist)
π§΅ Each MCP server runs in its own thread
ποΈ No need for a database β JSON configuration for easy editing and portability
π§βπ» Users can define their own MCP server with custom ENV (auto-detected via Auth Bearer)
π‘οΈ Env Bearer Admin Hack β configurable env simulating Bearer admin (ideal for tests and quick changes)
π Built entirely on FastAPI Python + Pydantic for code clarity and safety
β Custom SSE stack based only on FastAPI (no Starlette)
β PyTest β tests run a live server instance and perform tests on a real running server (no mocking!)
β
π Working onβ¦
π€ Prompts β fixing some bugs with class injection into SSE
π₯οΈ WebUI Frontend with Marketplace (click and install)
Ready? Letβs get started with SimpleTool Server!
π Quickstart
Assistant
Responses are generated using AI and may contain mistakes.