AI代理成本管理服务器

Metrx MCP Server是一款AI代理成本智能平台,提供实时成本仪表板、模型选择优化、预算执行和ROI跟踪功能。

  • by metrxbots
  • TypeScript
  • 混合部署
  • 2 星标
  • 更新于
在 GitHub 查看 metrxbots/mcp-server

使用说明

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密钥:

  1. METRX_API_KEY 环境变量
  2. ~/.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)。npm作用域是 @metrxbot Smithery的上市是 metrxbot/mcp-serverGitHub组织是 metrxbots (与A s)因为 metrxbot 已经在GitHub上发布了。如果你看到 metrxbot 对比 metrxbots 跨平台,它们是同一个项目——只是GitHub命名空间约束。

许可证

麻省理工学院——见 许可证.

💬 反馈

Metrx为你工作吗?我们很想听听,无论是好是坏。

如果您安装了但遇到了问题,请告诉我们发生了什么——我们会阅读每一份报告。