MCP代理可视化仪表板

MCP Proxy Studio 是一个可视化仪表板,用于创建、运行和监控MCP代理(包括stdio、SSE、可流式HTTP和OpenAPI),提供实时日志、集成检查器和自动启动流程功能。

  • by lucasiscovici
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 lucasiscovici/mcp-proxy-studio

使用说明

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 (/<route>)
MCP检查器UI 6274 (服务器:6277)

🧩 流动模型

来源

  • 标准 –命令/args/env
  • SSE –URL+标题
  • streamable_http –URL+标题
  • 开放API –基本URL+规范→ 生成自动助手

目标

  • sse
  • streamable_http
  • openapi

OpenAPI源始终指向 streamable_http.

结果端点

  • 可流化目标→ http://<host>:8001/<route>/mcp
  • SSE目标→ http://<host>:8002/<route>/sse
  • OpenAPI目标→ http://<host>:8003/<route>

🖥 使用UI

  1. 创建 流动
  2. 启动/停止 (按流量或全局)
  3. 检查 –打开已配置的MCP检查器
  4. 监视器 –具有可选持久性的实时事件流
  5. 配置 –自动启动行为和设置

📚 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-Studio
make dev

🚢 生产(版本图像)

make prod

❗ 故障排除

  • OpenAPI→ 404:检查上游MCP
  • 标准问题:确保 npx, uvx,或 docker 存在于PATH中
  • 无法联系到检查员:检查端口 6274/6277

⭐ 星迹


许可证

麻省理工学院