mcp-tax Skill 技能

技能简介

mcp-tax 是一款零依赖的 MCP 上下文令牌税审计工具，通过一行命令扫描 Claude Code 中已配置的 MCP 服务器，以真实 JSON-RPC 握手方式获取各服务器的完整工具模式（Tool Schema），精确计算每个服务器消耗的上下文窗口 tokens，并生成一份可直接分享的 HTML 税务收据。帮助开发者识别哪些 MCP 工具包正在悄悄吞噬 AI 的「脑容量」，从而有依据地决定暂时关闭哪些服务器。

核心能力

• 真实握手审计：通过 stdio 与每个 MCP 服务器建立真实的 JSON-RPC 连接（initialize + tools/list），而非猜测或解析配置文件，确保数据准确
• Token 消耗估算：将每个工具的 name + description + inputSchema 做 JSON.stringify，取字符数 ÷ 4 作为估算 token 量，叠加得出总消耗
• 可视化 HTML 收据：生成 tax-receipt.html，以图表形式展示各服务器税务负担占比，支持直接分享
• 灵活开关服务器：通过 mcp-tax off/on 命令按名称禁用/启用指定服务器，影响 mcp-tax run 的行为，不修改用户原始配置文件
• 多配置源扫描：自动合并扫描 ~/.claude.json、./.mcp.json、Claude Desktop 配置，无需手动指定
• Claude Code 集成：mcp-tax run 自动生成过滤后的 MCP 配置并通过 --mcp-config 传递给 Claude Code，实现零手动干预

安装配置

环境要求

• Python 3.9 或更高版本
• Node.js 环境（用于 Claude Code 配置扫描）

安装方式（PyPI）

pip install git+https://github.com/hahahahahahahahah6/mcp-tax.git
# 或使用 pipx（推荐）
pipx install git+https://github.com/hahahahahahahahah6/mcp-tax.git

安装方式（npm）

npx mcp-tax

使用步骤

第 1 步：查看已配置的 MCP 服务器

mcp-tax list
# 输出示例：
# github
#   npx -y @modelcontextprotocol/server-github
# postgres [off]
#   uvx mcp-server-postgres --db-url ...
# 2 server(s), 1 disabled

第 2 步：执行 Token 税审计

mcp-tax audit
# 输出示例：
# server    tools  schema chars  est. tokens
# ------  -------  ------------  -----------
# github       51       118,203        29,551
# postgres [off]    9        12,440         3,110
# ------  -------  ------------  -----------
# TOTAL        60       130,643        32,661
# ~16.3% of a 200k context window

第 3 步：关闭高消耗服务器

mcp-tax off postgres
# postgres disabled (affects mcp-tax run)

第 4 步：以过滤配置启动 Claude Code

mcp-tax run -- -p "summarize this repo"
# mcp-tax: 2 server(s), 1 disabled -> ~/.config/mcp-tax/mcp-config.filtered.json

适用场景

• 多 MCP 服务器并行运行：当 Claude Code 配置了 6+ 个 MCP 服务器时，定期审计找出吃掉 10-15% 上下文窗口的「税务大户」
• AI API 成本优化：通过 token 消耗估算换算 API 费用，量化每个 MCP 工具的真实金钱成本
• 团队协作共享：生成 HTML 收据发给团队成员，展示为什么某个 MCP 工具需要被暂时关闭
• CI/CD 自动化：结合 --json 输出，在 CI 管道中自动检查新引入的 MCP 服务器对上下文窗口的影响

适用人群

• 日常使用 Claude Code 进行编程的开发者
• 需要管理多个 MCP 服务器的 AI 工程团队
• 关注 AI Token 消耗和成本优化的个人开发者

工作原理

mcp-tax 通过以下步骤完成审计：

1. 配置扫描：按优先级读取 ~/.claude.json、./.mcp.json 和 Claude Desktop 配置，合并所有 mcpServers 条目
2. JSON-RPC 握手：对每个 stdio 类型的服务器，启动进程并发送 initialize + tools/list 请求，捕获完整响应
3. Token 估算：对每个工具，取 JSON.stringify({ name, description, inputSchema }) 的字符数 ÷ 4 作为估算 token 量
4. 收据生成：将所有服务器的消耗数据汇总，生成 HTML 税务收据，包含总消耗、百分比和分项明细

> 注意：仅支持 stdio 传输类型的 MCP 服务器；HTTP/SSE 类型服务器会被列出并标记「未计入」。

官方链接

• PyPI 包地址：https://pypi.org/project/mcp-tax/
• GitHub 仓库：https://github.com/hahahahahahahahah6/mcp-tax
• npm 一键运行：npx mcp-tax