上一篇写到如何用golang实现一个mcp server,没想到获得了许多的点赞和收藏,今天就来说下如何调试你写的mcp server。虽然说你可以通过直接配置到 Claude for Desktop、cline等实现mcp client的客户端上调试,或者通过打印日志来查看执行记录,但是都不如官方提供的MCP Inspector好用,接下来我们就简单讲讲如何使用它。
什么是 MCP Inspector?
MCP Inspector 是一个开源开发工具,旨在简化 MCP 服务器的调试和测试过程。它通过提供直观的用户界面,使开发者能够轻松检查和验证服务器的功能和兼容性。
MCP Inspector 的主要功能
-
服务器连接管理:MCP Inspector 提供了多种连接方式,支持本地和远程服务器的连接。开发者可以根据需要选择不同的传输方式进行连接。
-
服务浏览 :连接成功后,用户可以在浏览器中访问
http://localhost:5173
,查看 MCP 服务器所提供的各种服务,如工具(Tools)、资源(Resources)、提示(Prompts)等,并能够调用这些工具服务。 -
协议兼容性测试:MCP Inspector 允许开发者测试服务器的协议兼容性,确保服务器与客户端之间的通信符合 MCP 标准。这对于调试和优化服务器至关重要。
如何使用 MCP Inspector?
使用 MCP Inspector 非常简单。首先,确保你的系统已安装 Node.js。然后,你可以通过以下命令启动 Inspector:
bash
npx @modelcontextprotocol/inspector
启动后,打开浏览器访问 http://localhost:5173
即可开始使用。
这里我继续以上个实现计算器的mcp server为例,来说下MCP Inspector的使用。
- 首先确保本地安装了 Node.js,因为最新版本的npm支持npx,所以安装完 Node.js,升级下npm;
bash
npm install -g npm@latest
- 然后就可以按照官方仓库的命令来调试你的mcp server了,这里我们使用的是golang版本的mcp server,所以命令如下:
bash
# 这里命令行在main文件的当前目录下
npx @modelcontextprotocol/inspector go run main.go
- 启动成功后,打开浏览器访问
http://localhost:5173
,即可看到如下界面:
因为我们只写了一个tool,所以到Tools中点击List Tools只能看见calculator,选中后参数在右边填写:
输入add,x=10,y=15,然后run tool,即可在下面的history查看执行记录:
以上就是一个简单的Inspector调试的使用。
总结
从上面的一个简单的示例可以看到,MCP Inspector 的优势非常明显,它可以极大的减少你使用 Claude for Desktop去调试所消耗的token量;图形可视化的界面,也远比看日志方便的多,我这里只是简单的说下这个工具的使用,更多功能需要你来探究。
总之,MCP Inspector 为开发者提供了一个强大的平台,简化了 MCP 服务器的调试和测试过程。通过使用 MCP Inspector,开发者可以确保服务器与客户端之间的兼容性,优化工具调用体验,提升应用的整体质量和性能。