调试MCP服务

本文介绍如何通过控制台和MCP Inspector调试MCP服务。

通过控制台调试MCP服务

  1. AI 网关控制台的实例页面,选择您实例所在的地域。

  2. 进入目标实例页面,选择左侧导航栏的MCP管理

  3. MCP管理页面,单击目标MCP服务卡片。

  4. 单击调试页签,控制台会自动跟后端MCP Server建立连接,同时您可以在控制台查看连接建立状态。

    说明

    如果连接失败会有对应的错误提示,建连失败的常见原因如下:

    • 如果使用的是AI网关提供的测试域名,存在调用限额,每天整个域名限额1000次。

    • 如果使用的是自定义域名,需要确保此域名在公网可解析,且此域名解析的地址公网可达。

    • 如果开启了消费者鉴权,请确保使用的认证信息正确。

    • 不支持内网域名调试。

  5. 如果开启了消费者认证,需要选择对应已授权消费者作为请求参数传入。

  6. 单击获取工具,选择您需要使用的工具,填入工具参数即可在线调试。

    如果所选消费者只授权了MCP工具级别消费者认证,且仅授权某些工具的情况下,HTTPMCP的场景中获取工具列表只能看到和调用有权限的工具;直接代理场景调试的时候能看到全部工具,选择授权的工具调用是ok的,没权限的会403。

通过MCP Inspector调试MCP服务

说明

建议在本地启动MCP Inspector进行MCP调试。

MCP InspectorMCP社区提供的调试工具,可用于MCP服务全流程的调试。

  1. 安装Node.js环境

  2. 执行MCP Inspector安装命令:npx @modelcontextprotocol/inspector node build/index.js

  3. 访问MCP Inspector界面,例如通过浏览器登录以下地址:http://127.0.0.1:6274

    image

  4. 配置连接信息。

    image

    1. 选择传输类型:Transport Type选择SSE

    2. 输入URL地址:在MCP管理的基本信息页右侧获取。

    3. (可选)若配置了消费者认证,单击Authentication安装展开授权配置,并填写消费者身份对应的Token。以下图的凭证配置为例,Header NameAuthorization不需要修改,在Bearer Token中填入 HereIsToken

      image.png

  5. 单击Connect进行连接,连接成功后可以看到中间出现List Tools按钮,单击List Tools获取MCP服务的所有工具。

  6. (可选)若要调试具体的工具,点击工具名称,在右侧填写必要的参数,并单击Run Tool进行工具调用调试。