调试基于Cangjie Magic的MCP服务器指南

目录

引言

测试工具MCP Inspector

安装MCP Inspector

启动服务器进行测试

结束语

---

引言

最近打算用Cangjie Magic写一个MCP服务器，在写之前先用工具测试一下官方的MCP服务器示例，学习一下相关工具的使用。

测试工具MCP Inspector

Model Context Protocol (MCP) Inspector 是用于调试和监控基于 MCP 通信的工具，主要用于分析模型与客户端之间的交互过程。其核心功能包括：

1. 实时监控通信内容

   • 捕获 MCP 协议的请求和响应数据
   • 显示消息的 JSON 结构、参数和返回值
   • 支持过滤特定类型的消息（如文本生成、嵌入向量等）

2. 性能分析

   • 记录请求处理时间和吞吐量
   • 分析模型响应延迟和瓶颈点
   • 生成性能指标图表（如响应时间分布）

3. 错误诊断

   • 高亮显示异常和错误消息
   • 跟踪错误堆栈和上下文信息
   • 支持请求重放测试

4. 协议验证

   • 检查消息格式是否符合 MCP 规范
   • 验证参数类型和取值范围
   • 检测协议版本兼容性问题

安装MCP Inspector

我使用的是华为云的开发者主机，它的NodeJS版本比较低，需要先升级NodeJS的版本。

npm 提供了一个名为 n 的工具，可以帮助升级或管理 Node.js 版本。以下是具体方法：

安装 n 工具：

npm install -g n

升级到最新长期支持版（LTS）：

n lts

 MCP Inspector 可以通过 npx 直接运行，无需额外安装：

# 基本语法
npx @modelcontextprotocol/inspector <命令>

启动服务器进行测试

启动Cangjie Magic的MCP服务器的命令行是：

cjpm run --skip-build --name magic.examples.mcp_server

所以使用下面的命令行就可以启动MCP服务器并进行测试：

npx @modelcontextprotocol/inspector cjpm run --skip-build --name magic.examples.mcp_server

 MCP Inspector会启动浏览器并显示下面的界面。

点击Connect按钮就可以连接到MCP服务器。

 此时点击Tools标签，然后点击List Tools就可以查看到MCP服务器所提供的工具，并进行功能测试。

 

结束语

今天学习了相关测试工具，为后面的MCP服务器开发做好了准备。