MCP Proxy Studio
A visual dashboard to create, run and monitor MCP proxies — stdio, SSE, streamable HTTP & OpenAPI.
Zero CLI friction. Live logs. Integrated Inspector. Auto-start flows.
______________________________________________________________________
🎥 演示(截图)
- 仪表板概述\
- 流程编辑器\
- 现场活动
- 检查员集成
- 分析仪表板
______________________________________________________________________
🚀 特性
- 可视化流生成器 –管理您的stdio、SSE、流式HTTP和OpenAPI流。
- 集成MCP检查器 –按流量或全局启动,自动配置。
- 实时事件订阅源 –具有可选持久性的实时日志。
- OpenAPI桥 –自动产卵
@ivotoby/openapi-mcp-server当需要时。 - 自动启动系统 –Flows&Inspector可以通过安全状态处理自动启动。
- 简洁的用户界面,无框架 –所有香草JS都有SSE实时反馈。
- 分析仪表板 –通过运输感知标签摄取生命跨度(
mcp_sse,mcp_http,openapi)、工具跨度、上游URL、HTTP方法、会话id、请求/响应正文以及用于排序的发送时间戳。
______________________________________________________________________
📦 快速开始
一个衬垫开始(npx)
npx -y github:lucasiscovici/MCP-Proxy-Studio start一行开始(uvx)
uvx --from git+https://github.com/lucasiscovici/MCP-Proxy-Studio@main mcps start一个衬垫停止(npx)
npx -y github:lucasiscovici/MCP-Proxy-Studio stop一个衬垫停止(uvx)
uvx --from git+https://github.com/lucasiscovici/MCP-Proxy-Studio@main mcps stop其他(npx)
# Optional:
# npx -y github:lucasiscovici/MCP-Proxy-Studio status
# npx -y github:lucasiscovici/MCP-Proxy-Studio update
# Force replace container
npx -y github:lucasiscovici/MCP-Proxy-Studio start --force
npx -y github:lucasiscovici/MCP-Proxy-Studio update --force其他(uvx)
# Optional:
# uvx --from git+https://github.com/lucasiscovici/MCP-Proxy-Studio@main mcps status
# uvx --from git+https://github.com/lucasiscovici/MCP-Proxy-Studio@main mcps update
# Force replace container
uvx --from git+https://github.com/lucasiscovici/MCP-Proxy-Studio@main mcps start --force
uvx --from git+https://github.com/lucasiscovici/MCP-Proxy-Studio@main mcps update --force打开: http://localhost:8000 您的配置存储在 mcp-dashboard-data 音量。
______________________________________________________________________
🔧 港口
| 组件 | 端口 |
|---|---|
| 仪表板用户界面 | 8000 |
| 流式HTTP | 8001 |
| SSE活动 | 8002 |
| OpenAPI目标(mcpo) | 8003 (/) |
| MCP检查器UI | 6274 (服务器:6277) |
______________________________________________________________________
🧩 流动模型
来源
- 标准 –命令/args/env
- SSE –URL+标题
- streamable_http –URL+标题
- 开放API –基本URL+规范→ 生成自动助手
目标
ssestreamable_httpopenapi
OpenAPI源始终指向 streamable_http.结果端点
- 可流化目标→
http://:8001//mcp - SSE目标→
http://:8002//sse - OpenAPI目标→
http://:8003/
______________________________________________________________________
🖥 使用UI
- 创建 流动
- 启动/停止 (按流量或全局)
- 检查 –打开已配置的MCP检查器
- 监视器 –具有可选持久性的实时事件流
- 配置 –自动启动行为和设置
______________________________________________________________________
📚 OpenAPI管理
对于OpenAPI源:
- 自动运行:
npx -y @ivotoby/openapi-mcp-server
- 等待准备就绪
- 通过以下方式暴露目标
mcpo在 端口8003 - 检查器在以下情况下自动打开
/docs
______________________________________________________________________
🔌 内置(关键依赖项)
核心MCP工具
后端
- 快速API, Uvicorn, 派丹蒂克
- 异步, 子进程 编排
前端
- 普通JavaScript
- 事件源(SSE)
- 获取API
开发/运行时
- Docker/Docker组合
- 新巴拿马型船舶, uvx
______________________________________________________________________
⚙️ 环境变量
| 变量 | 描述 |
|---|---|
MCP_PROXY_BIN | 默认值: mcp-proxy |
MCP_OPENAPI_BIN | 默认值: uvx mcpo |
MCP_INSPECTOR_BIN | 默认值: npx -y @modelcontextprotocol/inspector |
MCP_INSPECTOR_PORT / MCP_INSPECTOR_SERVER_PORT | 检查员端口 |
______________________________________________________________________
🛠 开发说明
- 后端: FastAPI编排子进程并将配置持久化
mcp-dashboard-data体积 - 前端: 香草JS与modals+SSE更新
- 由容器启动ID保护的自动启动
______________________________________________________________________
🧑💻 发展
Docker编写产品
git clone https://github.com/lucasiscovici/MCP-Proxy-Studio.git && cd MCP-Proxy-Studiomake dev______________________________________________________________________
🚢 生产(版本图像)
make prod______________________________________________________________________
❗ 故障排除
- OpenAPI→ 404:检查上游MCP
- 标准问题:确保
npx,uvx,或docker存在于PATH中 - 无法联系到检查员:检查端口
6274/6277
______________________________________________________________________
⭐ 星迹

______________________________________________________________________
许可证
麻省理工学院
