MCPo Simple Server

Overview

MCPoSimpleServer is a lightweight, asynchronous platform that brings the Model Context Protocol (MCP) to developers looking for a fast, secure way to run and manage AI tools. By running in a Docker container, it isolates each tool in its own thread while providing a single Server‑Sent Events (SSE) connection for real‑time communication. This design eliminates the need for a heavy database or complex orchestration, allowing teams to spin up an MCP‑compliant server in minutes and immediately expose tools to any LLM client that understands the protocol.

The server’s core value lies in its dynamic tool loading and filtering capabilities. Developers can drop any MCP‑compatible tool into the container—whether it’s built with , , or another JavaScript runtime—and the server will automatically detect, load, and expose it. A whitelist/blacklist mechanism lets teams control which tools are available to end users, providing fine‑grained security without manual configuration. The JSON‑based configuration file is portable and human‑readable, making it trivial to version control or share across environments.

MCPoSimpleServer is built on FastAPI and Pydantic, giving developers full type safety and an auto‑generated Swagger UI. In addition to SSE, the server offers a REST endpoint and an OpenAPI.json file that is fully compatible with platforms such as OpenWebUI. This multi‑channel access means the same toolset can be consumed by chat interfaces, custom front‑ends, or automated pipelines without additional adapters. The embedded bearer‑token “admin hack” simplifies testing and quick configuration changes, while still allowing production deployments to use proper authentication mechanisms.

Real‑world scenarios include rapid prototyping of new AI assistants, sandboxing third‑party tool integrations for compliance reviews, and building internal knowledge bases that expose domain‑specific tools to a company’s LLMs. The ability to run an SSH daemon and Xfce via SupervisorD also opens the door to web‑based desktop access, enabling users to interact with graphical tools directly from a browser. Overall, MCPoSimpleServer provides a clean, modular, and secure foundation for developers who need to expose arbitrary tools to LLMs without the overhead of traditional server stacks.