🤔 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

🔗 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!)

Ready? Let’s get started with SimpleTool Server!