使用说明
Metrx MCP服务器
你的人工智能代理在浪费钱。 Metrx找出多少,并修复它。
官方 MCP服务器 为了 Metrx --人工智能代理成本智能平台。赋予任何与MCP兼容的代理(Claude、GPT、Gemini、Cursor、Windsurf)跟踪自身成本、检测浪费、优化模型选择和证明投资回报率的能力。
为什么选择Metrx?
| 问题 | Metrx做什么 |
|---|---|
| 无法查看代理支出 | 每个代理、模型和提供商的实时成本仪表板 |
| LLM通话费用过高 | 提供商套利为同一任务找到了更便宜的模型 |
| 失控成本 | 达到限额时自动暂停的预算执行 |
| 浪费的令牌 | 成本泄漏扫描程序检测到重试风暴、上下文膨胀、模型不匹配 |
| 无法证明人工智能投资回报率 | 收入归因将代理行为与业务成果联系起来 |
快速开始
立即尝试,无需注册
npx @metrxbot/mcp-server --demo
这将使用示例数据启动服务器,以便您可以立即浏览所有23个工具。
连接您的真实数据
选项A——交互式登录(推荐):
npx @metrxbot/mcp-server --auth
打开浏览器获取API密钥,对其进行验证,然后将其保存到 ~/.metrxrc 所以你永远不需要设置环境变量。
选项B——环境变量:
METRX_API_KEY=sk_live_your_key_here npx @metrxbot/mcp-server --test
在获取免费API密钥 app.metrxbot.com/signup.
添加到您的MCP客户端(Claude Desktop、Cursor、Windsurf)
如果你使用 --auth,没有 env 需要块——密钥从中读取 ~/.metrxrc 自动:
{
"mcpServers": {
"metrx": {
"command": "npx",
"args": ["@metrxbot/mcp-server"]
}
}
}
或者通过环境显式传递密钥:
{
"mcpServers": {
"metrx": {
"command": "npx",
"args": ["@metrxbot/mcp-server"],
"env": {
"METRX_API_KEY": "sk_live_your_key_here"
}
}
}
}
远程HTTP端点
对于远程代理(无需本地安装):
POST https://metrxbot.com/api/mcp
Authorization: Bearer sk_live_your_key_here
Content-Type: application/json
来自npm
npm install @metrxbot/mcp-server
10个领域的23个工具
仪表板(3个工具)
| 工具 | 说明 |
|---|---|
metrx_get_cost_summary |
全面的成本汇总——总支出、通话次数、错误率和优化机会 |
metrx_list_agents |
列出所有代理的状态、类别、成本指标和健康指标 |
metrx_get_agent_detail |
详细的代理信息,包括模型、框架、成本明细和性能历史 |
优化(4个工具)
| 工具 | 说明 |
|---|---|
metrx_get_optimization_recommendations |
每个代理或整个车队的人工智能成本优化建议 |
metrx_apply_optimization |
一键将优化建议应用于代理 |
metrx_route_model |
基于复杂性的特定任务模型路由推荐 |
metrx_compare_models |
比较不同供应商的LLM模型定价和功能 |
预算(3个工具)
| 工具 | 说明 |
|---|---|
metrx_get_budget_status |
所有预算配置的当前状态,包括支出与限制 |
metrx_set_budget |
通过硬、软或监控执行来创建或更新预算 |
metrx_update_budget_mode |
更改现有预算的执行模式或暂停/恢复它 |
警报(3个工具)
| 工具 | 说明 |
|---|---|
metrx_get_alerts |
为您的代理车队提供主动警报和通知 |
metrx_acknowledge_alert |
将一个或多个警报标记为已读/已确认 |
metrx_get_failure_predictions |
预测性故障分析——在故障发生之前识别可能发生故障的代理 |
实验(3个工具)
| 工具 | 说明 |
|---|---|
metrx_create_model_experiment |
开始A/B测试,比较两个具有流量分流的LLM模型 |
metrx_get_experiment_results |
统计显著性、成本增量和建议措施 |
metrx_stop_experiment |
停止正在运行的模型路由实验并锁定获胜者 |
成本检漏仪(1个工具)
| 工具 | 说明 |
|---|---|
metrx_run_cost_leak_scan |
对整个代理车队进行全面的7项成本泄漏审计 |
归因(3个工具)
| 工具 | 说明 |
|---|---|
metrx_attribute_task |
将代理操作与业务成果联系起来,以跟踪投资回报率 |
metrx_get_task_roi |
计算代理人的投资回报率——成本与归因结果 |
metrx_get_attribution_report |
多来源归因报告,包括信心评分和主要贡献者 |
警报配置(1个工具)
| 工具 | 说明 |
|---|---|
metrx_configure_alert_threshold |
通过电子邮件、webhook或自动暂停设置成本或操作警报阈值 |
投资回报率审计(1个工具)
| 工具 | 说明 |
|---|---|
metrx_generate_roi_audit |
为您的AI代理团队准备好的投资回报率审计报告 |
升级理由(1个工具)
| 工具 | 说明 |
|---|---|
metrx_get_upgrade_justification |
基于当前使用模式的分层升级投资回报率报告 |
提示
常见工作流的预构建提示模板:
| 提示 | 描述 |
|---|---|
analyze-costs |
全面的成本概述——支出明细、顶级代理商、优化机会 |
find-savings |
发现优化机会——模型降级、缓存、路由 |
cost-leak-scan |
扫描浪费模式——重试风暴、超大上下文、模型不匹配 |
示例
“我花了多少钱?”
User: What was my AI cost this week?
→ metrx_get_cost_summary(period_days=7)
Total Spend: $234.56 | Calls: 2,450 | Error Rate: 0.2%
├── customer-support: $156.23 (1,800 calls)
└── code-generator: $78.33 (650 calls)
💡 Switch customer-support from GPT-4 to Claude Sonnet: Save $42/week
“找到我的储蓄”
User: Am I overpaying for my agents?
→ metrx_compare_models(models=["gpt-4o", "claude-3-5-sonnet", "gemini-1.5-pro"])
Model Comparison (per 1M tokens):
├── gpt-4o: $2.50 in / $10.00 out
├── claude-3-5-sonnet: $3.00 in / $15.00 out
└── gemini-1.5-pro: $3.50 in / $10.50 out
“测试更便宜的型号”
User: Test Claude 3.5 Sonnet against my GPT-4 setup
→ metrx_create_model_experiment(agent_id="agent_123",
model_a="gpt-4o", model_b="claude-3-5-sonnet-20241022", traffic_split=10)
Experiment started: 90% GPT-4o, 10% Claude 3.5 Sonnet
Check back in 14 days for statistical significance.
配套工具:成本检漏仪
此回购还包括 @metrxbot/cost-leak-detector -一个免费的离线CLI,用于扫描LLM API日志以查找浪费的开支。没有注册,没有云,没有数据离开你的机器。
npx @metrxbot/cost-leak-detector demo
它运行7次检查(空闲代理、高级模型过度使用、缺少缓存、高错误率、上下文溢出、无预算、套利机会),并在几秒钟内为您提供一份评分报告。请参阅 完整文档.
配置
API密钥(必需)
服务器按以下顺序查找您的API密钥:
METRX_API_KEY环境变量~/.metrxrc文件(由创建--auth)
跑 npx @metrxbot/mcp-server --auth 保存密钥,或直接设置envvar。
| 变量 | 必填 | 描述 |
|---|---|---|
METRX_API_KEY |
是* | 您的Metrx API密钥(免费获得一个) |
METRX_API_URL |
否 | 覆盖API基本URL(默认值: https://metrxbot.com/api/v1) |
*如果您已经跑步,则不需要 --auth --从以下位置读取密钥 ~/.metrxrc 自动。
CLI标志
| 标志 | 描述 |
|---|---|
--demo |
从样本数据开始-不需要API密钥或注册 |
--auth |
交互式登录--打开浏览器,验证密钥,保存到 ~/.metrxrc |
--test |
验证API密钥和连接 |
速率限制
每个工具每分钟60个请求。如需更高的限制,请联系support@metrxbot.com.
发展
git clone https://github.com/metrxbots/mcp-server.git
cd mcp-server
npm install
npm run typecheck
npm test
贡献
看 贡献.md 作为指导方针。
链接
- 网站: metrxbot.com
- 文档: docs.metrxbot.com
- npm: @metrxbot/mcp服务器
- 史密瑟里: metrxbot/mcp服务器
- 支持: support@metrxbot.com
关于命名的注记
该产品是 椎间盘镜 (metrxbot.com)。npm作用域是 @metrxbot Smithery的上市是 metrxbot/mcp-serverGitHub组织是 metrxbots (与A s)因为 metrxbot 已经在GitHub上发布了。如果你看到 metrxbot 对比 metrxbots 跨平台,它们是同一个项目——只是GitHub命名空间约束。
许可证
麻省理工学院——见 许可证.
💬 反馈
Metrx为你工作吗?我们很想听听,无论是好是坏。
如果您安装了但遇到了问题,请告诉我们发生了什么——我们会阅读每一份报告。