mcp-checkup

mcp-checkup

你的 MCP 服务正在占用上下文窗口。了解它们占用了多少。

mcp-checkup 是一款 MCP 服务，可分析你的 MCP 配置——测量每个已安装服务和工具的 Token 开销、查找重复项、评估效率，并生成优化报告。

快速开始

npx mcp-checkup

然后向你的 AI 助手提问：

"Run an MCP health check on my setup"
"How many tokens are my MCP servers using?"
"Generate an MCP health report"

为什么？

每个 MCP 工具仅其架构就要占用 550–1,400 个 Token。一个拥有 50 个工具的服务可能会占用 30,000 多个 Token，而你甚至还没开始输入。大多数开发者都不知道自己的 MCP 服务占用了多少上下文窗口。

社区中的真实案例：

• 添加 GitHub MCP 后，一位用户的 Token 使用量从 34K 增加到 80K（来源）
• 一位开发者发现，在开始任何对话之前，仅 4 个服务就已占用了 67,000 个 Token（来源）
• Context7（每周下载量 240K）的工具描述所需 Token 是必要数量的 3 倍（来源）

工具

analyze_servers

扫描你的 MCP 配置，测量每个已安装服务的 Token 开销。自动检测配置文件。

"Which of my MCP servers costs the most tokens?"

analyze_tools

深入分析特定服务——逐个查看工具的 Token 开销、评级、冗长描述和优化建议。

"Break down the token cost of my GitHub MCP server"

find_duplicates

查找已安装服务中重复的工具名称。冗余工具只会浪费上下文，没有任何好处。

"Do any of my MCP servers have overlapping tools?"

count_tokens

统计任意文本中的 Token 数量。可用于估算上下文用量。

"How many tokens is this prompt?"

generate_report

生成完整的 Markdown 健康报告：服务评级（A-F）、Token 开销、重复项和可执行的建议。

"Generate a full MCP health report"

评级系统

单个工具的评级

评级	Token 数量	含义
A	≤100	极佳——上下文开销极小
B	≤300	良好——架构大小合理
C	≤600	一般——可以优化
D	≤1000	较差——架构臃肿
F	>1000	不合格——严重影响上下文窗口

单个服务的评级

评级	Token 总数	含义
A	≤500	精简高效
B	≤1500	合理
C	≤3000	开始变得臃肿
D	≤6000	上下文开销显著
F	>6000	严重占用上下文窗口

安装

Claude Desktop / Claude Code

{
  "mcpServers": {
    "mcp-checkup": {
      "command": "npx",
      "args": ["-y", "mcp-checkup"]
    }
  }
}

Cursor

使用相同格式将其添加到 .cursor/mcp.json。

自动检测

mcp-checkup 会自动在以下位置查找你的 MCP 配置：

• .mcp.json（当前目录）
• Claude Desktop 配置（Windows/macOS/Linux）
• .cursor/mcp.json

也可以为任何工具传入自定义路径。

对比

工具	用途	方式
mcp-checkup	诊断 Token 开销	分析并报告——准确查看每个工具的开销
lean-ctx	减少 Token 用量	在运行时压缩上下文
MCP Inspector	调试 MCP 服务	测试连接和工具调用

先使用 mcp-checkup 找出问题，再决定如何解决。

MCP 工具包的一部分

查看所有服务 →

• webcheck-mcp — 网站健康分析
• git-summary-mcp — Git 仓库情报
• mcp-checkup — MCP 配置健康分析器
• dev-utils-mcp — 开发者实用工具
• codescan-mcp — 代码库健康扫描器
• deadlink-checker-mcp — 无效链接检测器

许可证

MIT