MCP服务器调试工具

一款用于检查和调试模型上下文协议(MCP)服务器的原生macOS应用程序,提供服务器管理、连接状态监控、工具调用和日志记录等功能。

  • by subpop
  • Swift
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 subpop/mcpinspector

使用说明

MCP检查员

用于检查和调试的本地macOS应用程序 模型上下文协议(MCP) 服务器。

特性

  • 服务器管理 --使用自定义命令、参数和环境变量配置多个MCP服务器
  • 连接状态 --实时连接状态与服务器信息和功能概述
  • 工具浏览器 --查看所有可用工具及其输入模式,并使用基于表单的UI或原始JSON直接调用它们
  • 提示浏览器 --探索服务器暴露的提示及其参数
  • 资源浏览器 --使用URI和MIME类型信息浏览资源
  • JSON-RPC日志 --通过按方向(请求/响应/stderr)和搜索进行过滤,可以完全查看所有发送和接收的消息
  • 日志导出 --将日志保存为JSON以供离线分析
  • 配置导出 -以流行客户端的格式保存配置数据(Visual Studio Code、Cursor、Claude Code、Gemini、Codex)

安装

下载最新版本 这里。目前可从源代码处编译。

需求

  • macOS 26.0(索诺玛)或更高版本
  • Xcode 26.0或更高版本

构建步骤

  1. 克隆存储库:

    git clone https://github.com/subpop/MCPInspector.git
    cd MCPInspector
    
  2. 在Xcode中打开项目:

    open "MCP Inspector.xcodeproj"
    
  3. 在项目设置中选择您的开发团队(签名和功能)

  4. 构建并运行 ⌘R 或 产品→ Run

用法

添加服务器

  1. 点击 + 侧边栏工具栏中的按钮
  2. 输入名称、要运行的命令、任何参数和可选环境变量
  3. 点击 添加

MCP“everything”测试服务器的示例配置:

  • 姓名: Everything服务器
  • 命令: npx
  • 论据: -y @modelcontextprotocol/server-everything

您还可以右键单击侧边栏中的服务器进行编辑或删除。

启动服务器

  1. 从侧边栏中选择服务器
  2. 点击 开始 工具栏中的(播放)按钮,或单击 启动服务器 在详细视图中

连接后,详细信息视图将在中显示服务器名称、版本和可用功能 概述 选项卡。多个服务器可以同时运行——侧边栏底部显示了正在运行的服务器数量。

要停止服务器,请单击 停止 工具栏中的按钮,或右键单击侧边栏中的服务器并选择 停止.

检查工具、提示和资源

服务器运行后,使用详细视图顶部的选项卡栏在以下选项之间切换 工具, 提示, 资源,以及 日志。每个选项卡显示一个带有可用项目数量的徽章。

调用工具

  1. 切换到 工具 标签
  2. 从列表中选择一个工具(使用筛选字段进行搜索)
  3. 点击 呼叫工具
  4. 使用表格填写参数或切换到 原始JSON 模式
  5. 点击 执行 调用该工具并查看结果

查看日志

这 日志 选项卡显示应用程序和服务器之间的所有JSON-RPC流量。使用筛选器菜单仅显示请求、响应或stderr输出。您可以按方法名称或内容搜索日志,并将其导出到JSON文件以进行进一步分析。

许可证

麻省理工学院


制作❤️. 由...推动☕️ and 🤖.