内容
# MCP 健康检查
[](https://www.npmjs.com/package/mcp-checkup)
[](https://www.npmjs.com/package/mcp-checkup)
[](https://opensource.org/licenses/MIT)
你的 MCP 服务器正在消耗你的上下文窗口。找出消耗了多少。
**MCP 健康检查** 是一个 MCP 服务器，它分析你的 MCP 设置 — 衡量每个已安装的服务器和工具的令牌成本，查找重复项，评估效率，并生成优化报告。
## 快速开始
```bash
npx mcp-checkup
```
然后询问你的 AI 助手：
```
"对我的设置运行 MCP 健康检查"
"我的 MCP 服务器使用了多少令牌？"
"生成 MCP 健康报告"
```
## 为什么？
每个 MCP 工具仅其架构就消耗 **550–1,400 个令牌**。一个包含 50 个工具的服务器可以在你输入任何内容之前消耗 **30,000+ 个令牌**。大多数开发人员不知道他们的 MCP 服务器消耗了多少上下文窗口。
**社区中的真实例子：**
- 添加 GitHub MCP 将一位用户的令牌使用量从 34K 增加到 80K（[来源](https://github.com/github/github-mcp-server/issues/1286)）
- 一位开发人员发现仅 4 个服务器就消耗了 67,000 个令牌（[来源](https://mariogiancini.com/the-hidden-cost-of-mcp-servers-and-when-theyre-worth-it)）
- Context7（240K 每周下载量）的工具描述消耗的令牌是必要的 3 倍（[来源](https://dev.to/0coceo/the-1-most-popular-mcp-server-gets-an-f-2olm)）
## 工具
### `analyze_servers`
扫描你的 MCP 配置并衡量每个已安装服务器的令牌成本。自动检测配置文件。
```
"哪些 MCP 服务器的令牌成本最高？"
```
### `analyze_tools`
深入研究特定服务器 — 按工具划分的令牌成本、评分、臃肿的描述和优化建议。
```
"分析 GitHub MCP 服务器的令牌成本"
```
### `find_duplicates`
查找已安装服务器中重复的工具名称。冗余工具会浪费上下文而没有益处。
```
"我的 MCP 服务器是否有重叠的工具？"
```
### `count_tokens`
计算任何文本中的令牌。适用于估计上下文使用情况。
```
"这个提示有多少令牌？"
```
### `generate_report`
完整的 Markdown 健康报告：服务器评分（A-F）、令牌成本、重复项和可行的建议。
```
"生成完整的 MCP 健康报告"
```
## 评分系统
### 按工具评分
| 等级 | 令牌 | 含义 |
|-------|--------|---------|
| A | ≤100 | 优秀 — 上下文成本最小 |
| B | ≤300 | 良好 — 架构大小合理 |
| C | ≤600 | 一般 — 可以优化 |
| D | ≤1000 | 差 — 架构臃肿 |
| F | >1000 | 差 — 严重影响上下文窗口 |
### 按服务器评分
| 等级 | 总令牌 | 含义 |
|-------|-------------|---------|
| A | ≤500 | 精简高效 |
| B | ≤1500 | 合理 |
| C | ≤3000 | 较重 |
| D | ≤6000 | 显著的上下文成本 |
| F | >6000 | 主要上下文窗口消耗 |
## 安装
### Claude Desktop / Claude Code
```json
{
"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** | 诊断令牌成本 | 分析和报告 — 精确查看每个工具的成本 |
| [lean-ctx](https://github.com/yvgude/lean-ctx) | 减少令牌使用 | 运行时压缩上下文 |
| [MCP Inspector](https://github.com/modelcontextprotocol/inspector) | 调试 MCP 服务器 | 测试连接和工具调用 |
**首先使用 mcp-checkup** 查找问题，然后决定如何解决。
## MCP 工具包的一部分
**[查看所有服务器 →](https://yifanyifan897645.github.io/mcp-toolkit/)**
- [webcheck-mcp](https://www.npmjs.com/package/webcheck-mcp) — 网站健康分析
- [git-summary-mcp](https://www.npmjs.com/package/git-summary-mcp) — Git 仓库智能分析
- [mcp-checkup](https://www.npmjs.com/package/mcp-checkup) — MCP 设置健康分析器
- [dev-utils-mcp](https://www.npmjs.com/package/dev-utils-mcp) — 开发者工具
- [codescan-mcp](https://www.npmjs.com/package/codescan-mcp) — 代码库健康扫描器
- [deadlink-checker-mcp](https://www.npmjs.com/package/deadlink-checker-mcp) — 死链接检测器
## 许可证
MIT
