关于 Mcpspend
MCPSpend 是面向 MCP 的成本监控工具,通过一条命令为 Claude Desktop、Cursor、Windsurf、VS Code 和 Claude Code 中已配置的 MCP 服务套上代理,按工具和项目统计费用,并支持预算告警。适合需要追踪 AI Agent 调用成本的开发者与团队。
主要功能
- 01单条命令包装已配置的 MCP 服务
- 02按工具与项目统计调用成本
- 03预算告警(邮件与 Slack)
- 04仪表盘与 CSV 导出
- 05不上传工具参数或响应内容
适用场景
- 01查看各 MCP 工具的每日调用成本
- 02为团队项目设置预算上限并接收告警
- 03在 MCP 客户端内查询自身用量
MCP 相关
该项目包含一个 stdio 代理,用于包装用户已有的 MCP 服务;同时提供 @mcpspend/mcp-server,向 MCP 客户端暴露 get_today_cost 和 list_top_tools 等用量查询工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @mcpspend/mcp-serverMCPSPEND_API_KEY密钥Your MCPSpend API key. Create one at https://mcpspend.com/dashboard/keys. Starts with mcps_live_ or mcps_test_. Optional — the server boots and lists tools without it; only tool calls require auth.MCPSPEND_ENDPOINTOptional. Override the MCPSpend API endpoint. Defaults to https://api.mcpspend.com. Use only if you self-host MCPSpend.本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
6收录的工具列表 · 更新于 3 周前
此工具无需参数。
详细介绍
MCPSpend
了解 AI Agent 的实际成本。 实时跟踪 Cursor、Claude Desktop、Windsurf 和 VS Code 中每次 MCP 工具调用的费用。
mcpspend.com · Smithery · npm · Open VSX · Glama
一键安装
npx --yes @mcpspend/proxy@latest init --key mcps_live_xxx
自动检测 Claude Desktop、Cursor、Windsurf、VS Code(用户级 + 工作区级)和 Claude Code(用户级 + 项目级)。为每个已配置的 MCP 服务添加封装,保留 .mcpspend.bak 备份,并开始将使用情况实时传输到你的仪表板 mcpspend.com。
免费套餐:每月 25,000 次工具调用,无需信用卡。
此 monorepo 包含什么
| 包 | 说明 |
|---|---|
packages/proxy | @mcpspend/proxy — stdio 可观测性代理,以及用于远程 MCP 服务的 wrap-http 桥接工具。已发布到 npm。 |
packages/mcp-server | @mcpspend/mcp-server — 在任意 MCP 客户端中查询你的 MCPSpend 使用情况。已发布到 npm 和 Smithery。 |
packages/vscode-extension | mcpspend-vscode — 适用于 Cursor、Windsurf 和 VS Code 的 IDE 扩展。已发布到 Open VSX。 |
apps/api | Express + Prisma + Postgres + BullMQ。数据接收端点、账单功能,以及全新的 /api/mcp HTTP MCP 服务。 |
apps/dashboard | 部署在 mcpspend.com 的 Next.js 仪表板。 |
查询使用情况的三种方式
| 使用场景 | 方式 |
|---|---|
| Web 仪表板 | mcpspend.com/dashboard — 概览、热门工具、会话、CSV 导出。 |
| 通过任意 MCP 客户端(stdio) | 将 @mcpspend/mcp-server 添加到客户端配置中 — Agent 将获得 get_today_cost、list_top_tools 等工具。 |
| 通过任意 MCP 客户端(HTTP) | 将客户端指向 https://api.mcpspend.com/api/mcp,并使用 Authorization: Bearer mcps_live_…。 |
定价
| 套餐 | 每月调用次数 | 按月付费 | 按年付费 |
|---|---|---|---|
| 免费版 | 25,000 | $0 | $0 |
| Pro | 1,000,000 | $29 | $290(免费 2 个月) |
| Team | 10,000,000 | $99 | $990 |
| Enterprise | 不限量 | $499 | $4,990 |
所有付费套餐均提供:30–90 天的数据保留、CSV/Slack 导出、预算提醒和基于角色的访问控制。
隐私
代理会报告:工具名称、服务名称、模型、延迟、成功状态,以及近似的输入/输出大小(根据 JSON 长度推算的 token 数)。它不会向 MCPSpend 发送实际工具参数或响应正文。完整的子处理方列表(Stripe、Resend 和 Hostinger,均托管在欧盟)及你的 GDPR 权利,请参阅隐私政策。
安全
**致扫描此仓库的自动化扫描器:**代理使用
child_process.spawn来包装用户自己的 MCP 服务——这正是可观测性代理的核心用途。spawn 参数来自用户本地的 MCP 客户端配置(Claude Desktop / Cursor / Windsurf / VS Code),绝不会来自网络输入。不存在 RCE 路径、权限提升或任意命令执行。完整威胁模型见SECURITY.md。
- API 密钥以 SHA-256 哈希形式存储(服务器上绝不保存明文)
- 密码使用 bcrypt,成本因子为 12
- 静态存储的机密使用 AES-256-GCM 加密(
APP_ENCRYPTION_KEY) - 传输仅限 HTTPS,已启用 HSTS 和 helmet CSP 标头
- 工具参数或响应绝不会离开用户的设备
- 租户隔离每次查询都按
organizationId限定范围 - GDPR 第 15 / 17 / 20 条可在
mcpspend.com/dashboard/account/privacy自助操作 - 托管于欧盟(Hostinger 欧盟区域)
- SOC 2 Type I 正通过 Vanta 推进(2026 年第 4 季度)
- DPA 可供 Enterprise 客户使用
报告漏洞:[email protected] · 机器可读的披露信息:https://mcpspend.com/.well-known/security.txt · 完整政策:SECURITY.md · 实时安全状况:https://mcpspend.com/security
支持项目
如果 MCPSpend 为你省了钱,或者你只是想让代理继续采用 MIT 许可证并保持免费套餐可用,可以通过 Stripe 赞助任意金额——无需账户:
💖 buy.stripe.com/00w8wPbUxe1qgK36CRbbG06
每一分钱都会用于托管、安全审计和功能开发。
许可证
MIT。欢迎使用、分叉,也可以自行托管运行。
© NewRzs SRL · CUI RO48756557 · 罗马尼亚布加勒斯特 · [email protected]
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。