MCP调试工具

一款用于Model Context Protocol (MCP)服务器的桌面检查和调试工具,支持连接任何MCP服务器、手动发送请求并实时检查原始JSON-RPC响应。

  • by pkemkes
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 pkemkes/MCP-Fiddle

使用说明

MCP小提琴

⚠️ 免责声明: 这个代码库的大部分是由人工智能生成的。虽然它已经过审查和测试,但请自行使用。

桌面检查和调试工具 模型上下文协议(MCP) 服务器。思考 邮差,但专为MCP设计 --连接到任何MCP服务器,手动发送请求,并实时检查原始JSON-RPC响应。


特性

  • 连接到任何MCP服务器 通过 标准 (作为子进程生成)或 SSE/流式HTTP 运输
  • 请求构建器 --从下拉列表中选择MCP方法,用自动生成的表单字段填写参数,或使用原始JSON编辑器进行完全控制
  • 响应查看器 --语法高亮显示、可折叠的JSON显示,带有原始视图切换、错误高亮显示、时间戳和往返持续时间
  • 会话日志 --所有请求、响应和服务器发起的通知的按时间顺序的历史记录,可按方法或方向过滤
  • 探索侧栏 --单击一下 列出工具, 列出资源,以及 列表提示 按钮;单击任何结果以预填充请求生成器
  • 环境变量 --将自定义env变量传递给stdio生成的服务器进程

支持的MCP方法

方法 目的
initialize 握手和能力交流
notifications/initialized 客户准备就绪信号
ping 健康检查
tools/list / tools/call 发现和调用工具
resources/list / resources/read 发现并阅读资源
resources/subscribe 订阅资源更改
prompts/list / prompts/get 发现和检索提示
logging/setLevel 设置服务器日志级别
completion/complete 请求参数完成

技术栈

层 技术
前端 React 19、TypeScript、Vite
造型 顺风CSS
后端 Node.js、Express、, ws
MCP @modelcontextprotocol/sdk
桌面 电子

入门指南

先决条件

  • Node.js 18+及 npm

发展

npm install
npm run dev

这将同时启动Vite-dev服务器(前端热重载)和Electron应用程序。Electron主进程运行Express+WebSocket后端。配置服务器连接并开始探索。

示例--文件系统服务器

Command:  npx
Args:     -y, @modelcontextprotocol/server-filesystem, /tmp

点击 连接,然后使用请求生成器或发现侧边栏与服务器交互。

生产构建

npm run build:electron

这将构建前端和后端,然后将Electron应用程序打包为解包目录和安装程序。输出在 release/ 目录。


用法

  1. 配置 --在连接面板中输入stdio命令+args或SSE/HTTP URL。
  2. 连接 --点击 连接 生成/连接到MCP服务器并执行 initialize 握手。
  3. 发现 --使用侧边栏快捷方式列出可用的工具、资源和提示。
  4. 构建请求 --选择一种方法,填写参数(或编辑原始JSON),然后单击 发送.
  5. 检查 --查看格式化或原始JSON响应,检查错误,并查看完整的会话历史记录。

许可证

该项目根据 公共条款+MIT许可证。参见 许可证 了解全部细节。

太长,读不下去了 --免费使用、修改和共享。你可以 不 出售此软件或将其作为付费服务提供。