MCP 控制台 · 本地 MCP 服务管理工具

极简黑白灰风格的本地 Model Context Protocol 服务管理工具。后端使用 Node 内置模块，前端已预构建，装好 Node.js 18+ 后即可直接运行。

快速运行

Windows:

start.bat

PowerShell:

powershell -ExecutionPolicy Bypass -File start.ps1

macOS / Linux:

./start.sh

启动后打开 http://localhost:4178 。

功能概览

• 动态 MCP 索引：自动扫描已安装的 MCP 配置，不要求服务正在运行；覆盖 Codex、Claude Desktop、Claude Code、Qoder/QoderCN、Trae、Cursor、Workspace .mcp.json 与本地配置源。
• 全部已安装视图：跨客户端汇总所有已登记 MCP 服务，并自动标注来源、配置路径和当前状态。
• 服务管理：支持搜索、筛选、启用/禁用、编辑、删除、批量操作与真实健康检测。
• 一键服务库：内置 Filesystem、Memory、Fetch、GitHub、Git、PostgreSQL、SQLite、Puppeteer、Everything、HTTP/SSE 等常用 MCP 服务模板，可直接安装到当前配置源，也可先暂存为禁用状态。
• 配置源管理：展示每个 MCP 配置文件的路径、存在状态和可写状态，避免把 agent 地址写死在界面里。
• 配置文件编辑器：直接查看和编辑原始 JSON/TOML 配置，支持格式化、导入、导出、实时校验、自动 .bak 备份与原子写入。
• 工具调用与能力发现：健康检测会启动 MCP 服务并完成 initialize 握手，发现 tools/resources/prompts；服务详情中可按 inputSchema 自动生成工具调用表单。
• 日志与监控：SSE 实时事件流、历史事件记录和后台自动健康检查，便于排查启动、握手、调用和配置变更。

功能页面

仪表盘

展示当前配置源的服务总数、运行状态、异常数量、已发现工具数和最近检测结果。

服务管理

集中管理当前配置源中的 MCP 服务，支持状态筛选、批量删除、单条检测、详情查看和启用/禁用。

全部已安装

从常见 agent 工具安装路径中检索所有已登记 MCP 服务，即使服务未启动也会被索引，并自动标注所属 agent 与配置源。

服务库

提供常用 MCP 服务的一键安装入口，可安装到当前可写配置源，或以禁用状态暂存后再启用。

配置源

展示自动定位到的 Codex、Claude、Qoder、Trae、Cursor 等 MCP 配置文件路径，以及文件是否存在、是否可写。

配置文件

直接编辑当前配置源的原始配置，保存时会自动备份并校验结构。

日志与监控

查看手动检测、自动监控、工具调用、配置变更等事件，并可开启定时健康检查。

支持的 MCP 配置位置

| Agent | 自动识别的常见配置 | | --- | --- | | Codex | ~/.codex/config.toml | | Claude Desktop | %APPDATA%/Claude/claude_desktop_config.json、~/Library/Application Support/Claude/claude_desktop_config.json、~/.config/Claude/claude_desktop_config.json | | Claude Code | ~/.claude.json | | Cursor | ~/.cursor/mcp.json | | Qoder / QoderCN | %APPDATA%/QoderCN/SharedClientCache/mcp.json、~/.qoder/SharedClientCache/mcp.json、项目 .qoder/settings.local.json | | Trae | ~/.trae/mcp.json、项目 .trae/mcp.json | | Workspace | 项目 .mcp.json | | Local Store | server/data/mcp.json，由本工具自动创建 |

索引逻辑基于文件路径、文件名和配置格式动态识别 agent 类型；界面展示的地址来自后端扫描结果，不在前端写死。

设计约束

• 整体界面遵循极简风格，主题色限定为黑白灰。
• 不使用 Emoji 图标，所有图标均为内联 SVG 矢量图标。
• 点缀色仅用于错误、成功、警告等关键状态或重要操作。

目录结构

mcptool/
├── start.bat / start.ps1 / start.sh
├── server/
│   ├── src/
│   │   ├── index.js
│   │   ├── sourceIndex.js
│   │   ├── sources.js
│   │   ├── installedServers.js
│   │   ├── serviceCatalog.js
│   │   ├── configFormats.js
│   │   ├── configOps.js
│   │   └── mcpClient.js
│   └── test/
├── web/
│   ├── dist/
│   └── src/
└── docs/screenshots/

开发与验证

npm test
cd web
npm install
npm run build

后端测试使用 Node 内置测试运行器；前端使用 Vite + React + TypeScript。

安全说明

健康检测会真实启动本地 MCP 服务进程，工具调用也会执行服务暴露的能力。请只对可信服务执行检测或调用，并在写入配置前检查命令、参数和环境变量。