MCPOSimpleServer
About
MCPoSimpleServer is a lightweight, asynchronous API platform for running and managing MCP tools in isolated, secure environments. It implements the Model Context Protocol (MCP) for seamless integration with LLM applications.
Details
- Author
- getsimpletool
- GitHub stars
- 6
- Downloads
- 354
- Categories
- Other, API
Jump to
- Local Docker container with a single SSE-MCP connection
- Dynamic tool loading and filtering (whitelist/blacklist)
- Access via SSE, Swagger REST, and OpenAPI.json (OpenWebUI‑compatible)
- Each MCP server runs in its own thread for isolation
- JSON‑based configuration – no database required
- Bearer admin hack for simple authorization during testing
MCPoSimpleServer runs as a Docker container built on Debian 13 with a FastAPI/Python 3.13 server. Configuration is handled via a JSON file, and tools can be launched using uvx or npx. Users can define their own MCP servers with custom environment variables and access tools through SSE, Swagger REST, or OpenAPI endpoints.
MCPoSimpleServer
A Python-based LLM server that implements the Model Context Protocol (MCP).
🤔 What is MCPoSimpleServer?
MCPoSimpleServer is a lightweight, asynchronous API platform for running and managing MCP tools in isolated, secure environments. It implements the Model Context Protocol (MCP) for seamless integration with LLM applications.
📺 Demo
Check out our demo video to see MCPoSimpleServer in action:
✨ Key Features
- ✨ Local Docker container – your own local Docker container with a single SSE-MCP connection
- ⚡ Support quick and easy load 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 quick and easy load 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, ~260MB)
- 🔄 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)
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
