Use This MCP server To

Run MCP tools in isolated, secure Docker containers locally Dynamically load and filter MCP tools via whitelist/blacklist Expose MCP tools over SSE and OpenAPI for LLM clients Manage multiple MCP tools with thread isolation Configure MCP tool environments using JSON files Integrate MCP tools with OpenWebUI-compatible clients

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:

✨ 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)

mcpo-simple-server FAQ

How do I deploy MCPoSimpleServer locally?

You can deploy MCPoSimpleServer locally using its provided Docker container for quick setup and isolation.

What protocols does MCPoSimpleServer support for tool access?

It supports Server-Sent Events (SSE), Swagger REST API, and OpenAPI.json endpoints for flexible integration.

Can I dynamically add or remove MCP tools?

Yes, MCPoSimpleServer supports dynamic loading and filtering of tools using whitelist and blacklist configurations.

How does MCPoSimpleServer ensure tool isolation?

Each MCP tool runs in its own thread, ensuring isolated execution environments.

Is MCPoSimpleServer compatible with OpenWebUI?

Yes, it exposes OpenAPI.json compatible with OpenWebUI clients for seamless integration.

How is MCPoSimpleServer configured?

Configuration is JSON-based, making it easy to edit and portable across environments.

What programming language is MCPoSimpleServer built with?

MCPoSimpleServer is implemented in Python, leveraging asynchronous APIs for performance.

Can MCPoSimpleServer handle multiple MCP tools simultaneously?

Yes, it manages multiple tools concurrently with thread isolation to prevent interference.