MCP诊断服务器

MCP Probe是一个用于测试Model Context Protocol (MCP)客户端实现的诊断服务器,提供8种诊断工具和实时协议流量监控。

  • by eamonma
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 eamonma/mcp-probe

使用说明

MCP探头

用于测试模型上下文协议(MCP)客户端实现的诊断服务器。

它的作用

MCP Probe公开了8个诊断工具,这些工具可以执行MCP协议功能——任务、进度通知、取消、故障状态——因此开发人员可以验证他们的客户端是否正确处理了每个功能。实时仪表板实时显示所有协议流量。

为什么它存在

MCP的任务和进度功能(于2025年11月添加)缺乏测试工具。现有的MCP服务器做实际工作;这个纯粹是诊断性的。将任何MCP客户端指向它,以查看您的客户端支持什么以及它的行为方式。

快速开始

npm install
npm run dev          # Server at http://localhost:3000
npm run dev:dashboard # Dashboard at http://localhost:5173

项目结构

packages/
  server/     # MCP diagnostic server (Express + @modelcontextprotocol/sdk)
  dashboard/  # Real-time protocol viewer (React + Vite)
docs/
  spec.md     # Product specification
  PLAN.md     # Implementation plan

部署

Azure容器应用程序位于 mcp.eamon.io.CI/CD通过GitHub操作推送到main。

工具

工具 测试
simple_tool 基本工具调用
sync_with_progress 进度通知
pure_task 任务状态机
task_with_progress 任务+进度组合
cancellable_task 任务取消
multi_stage_task 进度消息更改
failing_task 状态处理失败
pausable_task 输入必填状态