MCP第5章：通过inspector调试mcp server文章介绍了 MCP Inspector 这一用于调试 MCP

本系列文章：

1. 概述

文章介绍了MCP Inspector这一用于调试MCP服务器的工具，包括其概述、通过该工具调试高德地图MCP Server、本地开发的牛排信息MCP Server及第三方文件系统MCP Server的方法。

2. inspector 概述

MCP Inspector 是针对 Model Context Protocol（MCP）服务器的交互式开发者工具，专注于测试与调试功能。

它使用便捷，可通过 npx 快速启动，无需复杂配置。能直观展示 MCP 服务器的上下文交互流程，支持请求模拟、响应分析等功能，帮助开发者验证服务器是否符合 MCP 规范。

工具界面简洁，实时反馈数据交互细节，便于定位问题，提升 MCP 服务器开发效率，是 MCP 生态中调试环节的实用工具。

官网：modelcontextprotocol.io/legacy/tool…

3. 直接在 MCP Inspector 页面调试 mcp server

待调试 mcp server 如下：

amap-maps-mcp-server 即高德地图 MCP Server，是面向大语言模型的地图服务接口集合。它支持 SSE 协议，以结构化、语义化方式提供 12 大核心服务，像地理编码、路径规划、天气查询等。其具有使用简单、自动升级、零运维成本等优势，能让 LLM 更便捷地调用地理信息服务。开发者可轻松接入，应用于智能客服、旅游规划、智能物流等多种场景，提升 AI 应用在位置相关任务中的表现。

{
  "mcpServers": {
    "amap-maps": {
      "disabled": true,
      "timeout": 60,
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@amap/amap-maps-mcp-server"
      ],
      "env": {
        "AMAP_MAPS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

直接执行下面inspector 调试命令，会自动打开调试页面 [http://localhost:6274/]：

npx @modelcontextprotocol/inspector

连接 mcp server

直接替换序号 1 和序号 2 中的命令和参数即可

执行 mcp server

4. 调试本地开发的 mcp server

参考的 mcp server 见

MCP第3章：开发案例合集(typescript-sdk + python-sdk)1. mcp server开发(通义 - 掘金

中第一个案例。该案例是通过通义灵码开发的，关于煎牛排信息的 mcp server

执行下面inspector 调试命令，会自动打开调试页面[http://localhost:6274/]：

npx @modelcontextprotocol/inspector node D:/project/AI/MCP/mcpserver/my-server3/steak.js

按照下面步骤获取到调试结果，如果有报错，则需按照提示排查

5. 调试第三方的 mcp server

待调试 mcp server 如下：

server-filesystem是 MCP 协议下的文件系统服务端工具，提供标准化文件操作能力。支持文件读写（含编码设置、部分读取）、目录管理（创建、列出、递归操作）、删除等功能，通过 path 定位资源，可配置权限、模式等参数。遵循 MCP 规范，作为中介让 AI 模型安全访问本地 / 远程文件，解决跨平台文件交互的兼容性问题，适用于文档处理、数据读写等场景。

{
  "mcpServers": {
      "github.com/modelcontextprotocol/servers/tree/main/src/filesystem": {
        "autoApprove": [],
        "disabled": true,
        "timeout": 60,
        "type": "stdio",
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-filesystem",
          "d:/project/AI/MCP/MCP_TEST"
        ]
      }
    }
}

inspector调试命令如下，会自动打开页面[http://localhost:6274/]

npx @modelcontextprotocol/inspector npx @modelcontextprotocol/server-filesystem d:/project/AI/MCP/MCP_TEST

按照下面步骤获取到调试结果，如果有报错，则需按照提示排查