MCPOSimpleServer

MCPoSimpleServer

一个基于 Python 的大模型服务，可实现 Model Context Protocol（MCP）。

🤔 什么是 MCPoSimpleServer？

MCPoSimpleServer 是一个轻量级异步 API 平台，可在隔离且安全的环境中运行和管理 MCP 工具。它实现了 Model Context Protocol（MCP），可与大模型应用无缝集成。

📺 演示

观看演示视频，了解 MCPoSimpleServer 的运行情况：

✨ 主要功能

• ✨ 本地 Docker 容器 —— 使用单个 SSE-MCP 连接运行专属的本地 Docker 容器
• ⚡ 支持快速、轻松地加载通过 uvx 或 npx 启动的任意 MCP 工具
• 🔄 动态加载和筛选工具（白名单/黑名单）
• 🌐 通过 SSE、Swagger REST 和 OpenAPI.json 访问 MCP 工具（兼容 OpenWebUI）
• 🐳 工具隔离 —— 每个工具都在独立线程中运行
• 🗄️ 基于 JSON 的配置 —— 易于编辑且可移植
• 🧑‍💻 支持使用自定义 ENV 参数启动自己的 MCP 服务
• 🛡️ Bearer 管理员 Hack —— 简单的管理员授权（适合测试和快速修改）
• 📝 异步 FastAPI Python 服务，提供完整的类型提示，让代码更清晰、更安全
• ✅ PyTest —— 快速、轻松地验证运行中服务的更改

🎉 当前已有功能

• 🔗 基于 Debian 13 构建的 Docker 容器，运行 FastAPI/Python 3.13 服务
• ⚡ 支持快速、轻松地加载通过 uvx 或 npx 启动的任意 MCP 工具
• 🌐 通过 SSE、Swagger REST 和 OpenAPI.json 访问 MCP 工具（兼容 OpenWebUI）
• 🆒 由 ENV 控制的 SupervisorD 可运行 SSHD + Xfce + noVNC（通过 Web/端口 6901 访问桌面，约 260MB）
• 🔄 动态加载和筛选 MCP 服务中的工具（白名单/黑名单）
• 🧵 每个 MCP 服务都在独立线程中运行
• 🗄️ 无需数据库 —— 使用 JSON 配置，便于编辑和移植
• 🧑‍💻 用户可以通过自定义 ENV 定义自己的 MCP 服务（通过 Auth Bearer 自动检测）
• 🛡️ ENV Bearer 管理员 Hack —— 可配置 ENV，模拟 Bearer 管理员（适合测试和快速修改）
• 📝 完全基于 FastAPI Python + Pydantic 构建，让代码更清晰、更安全
• ❌ 基于 FastAPI 构建的自定义 SSE 技术栈（不使用 Starlette）
• ✅ PyTest —— 测试会运行实时服务实例，并在实际运行的服务上执行测试（不使用模拟！）

🚀 正在开发

• 🤔 提示词 —— 修复将类注入 SSE 时的一些错误
• 🖥️ 带有 Marketplace 的 WebUI 前端（点击即可安装）