MCP服务器交互式UI工具

mcpplay是一款为MCP协议服务器提供即时交互式UI的工具,支持自动生成表单、实时结果查看和完整执行时间线记录。

  • by gauthierpiarrette
  • JavaScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 gauthierpiarrette/mcpplay

使用说明

mcpplay

The FastAPI /docs experience, for MCP servers.

Documentation • Getting Started • Issues

⚡ Run your MCP server → instantly get an interactive UI.

https://github.com/user-attachments/assets/ecaa69d9-b441-44d8-b709-93b168398858

麦克普雷 为您提供了一个基于浏览器的游乐场 主控程序-兼容服务器。只需一个命令,您就可以获得自动生成的表单、实时结果和完整的执行时间线。

专为 FastMCP 工作流程。适用于任何符合MCP的实施。

安装

pip install mcpplay
mcpplay demo

您的浏览器将打开 http://localhost:8321就是这样!

将其指向您自己的服务器

mcpplay run server.py
mcpplay run --command "node server.js"
mcpplay run --command "uvx my-mcp-server"

选项

mcpplay run server.py --port 9000        # Custom port (default: 8321)
mcpplay run server.py --no-open          # Don't auto-open browser
mcpplay run server.py --no-reload        # Disable hot reload
mcpplay run server.py --env API_KEY=xxx  # Pass env vars to server

特性

  • 模式感知表单 -从工具的JSON模式自动生成,具有枚举、嵌套对象、数组和默认值。
  • 现场执行 -运行工具,立即查看结构化结果。
  • 持续时间线 -每个呼叫都记录了输入、输出和延迟。只需单击一下即可重播。
  • 热重载 -编辑您的服务器,mcpplay将重新启动它。会话和时间线将保留。
  • 本地优先 -在本地主机上运行(127.0.0.1)通过Origin验证。默认情况下没有远程曝光。

比较

麦克普雷 MCP检查员 MCPJam检查员
安装 pip install npx (需要节点) Docker
Python原生 ✅ ❌ ❌
表单生成 完整JSON模式 基本输入 基本输入
热重载 ✅ ❌ ❌
执行时间表 持久、可重放 日志 日志

发展

git clone https://github.com/gauthierpiarrette/mcpplay
cd mcpplay

# Python backend
uv sync --dev
uv run pytest

# Frontend (Svelte)
cd frontend
npm install
npm run dev      # Dev server with HMR
npm run build    # Build to src/mcpplay/static/

许可证

Apache 2.0