https://github.com/getsimpletool/mcpo-simple-server
MCP Calling Servere via SSE and OpenAPI
https://github.com/getsimpletool/mcpo-simple-server
mcp mcp-server openapi openwebui sse
Last synced: 22 days ago
JSON representation
MCP Calling Servere via SSE and OpenAPI
- Host: GitHub
- URL: https://github.com/getsimpletool/mcpo-simple-server
- Owner: getsimpletool
- Created: 2025-03-06T17:37:22.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-11T22:31:12.000Z (9 months ago)
- Last Synced: 2025-09-18T12:53:45.245Z (6 months ago)
- Topics: mcp, mcp-server, openapi, openwebui, sse
- Language: Python
- Homepage:
- Size: 2.22 MB
- Stars: 7
- Watchers: 2
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **mcpo-simple-server** - MCP Calling Servere via SSE and OpenAPI `python` `mcp` `mcp-server` `openapi` `openwebui` `pip install git+https://github.com/getsimpletool/mcpo-simple-server` (🤖 AI/ML)
README
# 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:
[](https://www.youtube.com/watch?v=tQ6OhvC4eDQ)
## ✨ 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)