Token Oracle MCP

此仓库已存档，服务已关闭

TokenOracle MCP

令牌Oracle是一个模型上下文协议（MCP）服务器，它在代理使用令牌之前估计、比较和控制LLM API成本。它公开了九个工具、四个只读资源和一个cost_analysis_workflowPrompt模板。它使用专有的定价算法，没有支持LLM，以确保确定性的预算工作流程。

Token Oracle旨在与支持一名或零名员工公司的代理群体合作，在您的OpenClaw群体中充当一个小型首席财务官，降低支出并提出改进提示的建议。

保存他们的代币，立即致电Token Oracle！

暴露的MCP工具：

• estimate_cost -在执行之前估计单个LLM API调用的美元成本。输入：task_description、prompt_text、task_type或显式token_count。输出：cost_usd、recommended_model、confidence、will_fit_context、pricing_updated。注释：readOnlyHint：true，幂等提示：true，openWorldHint：false。
• estimate_cost_batch --一次通话最多可定价100个LLM任务。返回每个任务的细分、total_cost_usd和cheapest_model_for_all。在启动任何多步骤管道之前使用。
• compare_models --对给定任务的所有支持提供商的LLM定价进行排名。返回按成本排序的模型，包括speed_tier和quality_tier。支持按min_quality、max_cost_usd和提供者进行过滤。输入：task_type、token_count或prompt_text。
• budget_check --检查计划任务是否符合每月预算。返回can_proceed（布尔值）、remaining_budget_usd、budget_consumed_pct和带有savings_pct的廉价替代品。输入：monthly_budget_ussd、current_spend_usd和任务描述。
• find_cheapest_for_budget --与budget_check相反。给定预算_美元上限和任务，返回预算内的最佳模型/质量组合，加上按质量和成本排名的所有备选方案。

MCP资源暴露：

• token-oracle://meta --机器可读的服务器能力文档（版本、型号计数、定价元数据）
• token-oracle://models --带有元数据的模型ID，用于发现和验证
• token-oracle://heuristics --任务类型令牌启发式和关键字分类器模式（可审计）
• token-oracle://pricing/changelog --仅附加定价变更日志；用于检测随时间推移的定价更新

MCP提示已暴露：

• cost_analysis_workflow --引导式三步提示模板：估算_成本→ 比较模型→ budget_check。参数：task_description、monthly_budget_usd（可选）、quality_threshold（可选）。

支持的提供商： Anthropic、OpenAI、谷歌、Groq、Together AI、Mistral、DeepSeek、Cohere（100多个模型）。

规范代理工作流程示例： 目标：运行500个产品描述生成任务。预算50美元/月，当前支出43美元。

1. estimate_cost_batch（{任务：\[{任务类型：“生成”，标记计数：{输入：200，输出：800}，数量：500}\]}）→ 总成本：0.60美元
2. compare_models（{token_count：{input:200，output:800}，task_type：“generate”，min_quality:“med”，max_cost_usd:0.002}）→ deepseek-v3价格为0.00035美元/任务（总计0.175美元）——价格便宜71%，质量相同
3. budget_check（{每月预算_usd:50，当前支出-usd:43，标记计数：{输入：200，输出：800}，模型：“deepseek-v3”}）→ can_proceed：正确，剩余：6.825美元，预算_消费_百分比：2.4%

决定：使用deepseek-v3。与gpt-4o-mini相比，节省0.425美元。

定价：

• 免费：每天1000次API调用，所有托管工具通过远程端点，无信用卡
• Pro（29美元/月）：无限制调用、track_spend工具（每个API密钥的持久成本分类账）、优先级吞吐量、每个代理/任务/会话的支出归因

联系人： info@guffeyholdings.com

托管端点

• 规范远程MCP URL: https://mcp.guffeyholdings.com/TokenOracle
• 规范MCP名称： com.guffeyholdings/token-oracle

直接远程配置：

{
  "mcpServers": {
    "token-oracle": {
      "type": "streamable-http",
      "url": "https://mcp.guffeyholdings.com/TokenOracle",
      "headers": {
        "X-API-Key": "${TOKEN_ORACLE_API_KEY}"
      }
    }
  }
}

npm桥接包

对于仍然需要安装npm的stdio服务器的本地客户端，请使用 token-oracle-mcp.

零输入试验流程：

在没有API密钥的情况下启动网桥，并且当托管服务启用了试用身份验证时，它将在首次启动时自动获取和存储经过计量的试用凭据。

{
  "mcpServers": {
    "token-oracle": {
      "command": "npx",
      "args": ["-y", "token-oracle-mcp"]
    }
  }
}

一次性显式登录流程：

npx -y token-oracle-mcp login

随着 --api-key，验证并存储付费托管API密钥。没有 --api-key，它会请求并存储托管试用凭据。在任一流之后，MCP配置都不需要注入 TOKEN_ORACLE_API_KEY.

{
  "mcpServers": {
    "token-oracle": {
      "command": "npx",
      "args": ["-y", "token-oracle-mcp"]
    }
  }
}

如果您更喜欢无状态设置，请继续传递 TOKEN_ORACLE_API_KEY 作为环境变量。

托管审判行为：

• 试用凭据在服务器端进行计量和封顶
• 一旦达到托管试用请求限制，服务将返回需要升级的响应
• 托管服务为同一索赔人重用相同的仍然有效的试用凭据，而不是每次都铸造一个新的令牌
• 试用发布是单独限制的，可以通过服务器端滥用风险评分来阻止
• 稍后，托管升级流可以用付费凭据替换存储的试用凭据，而无需更改MCP配置

可选网桥环境变量：

• TOKEN_ORACLE_API_KEY：可选托管API密钥；覆盖任何存储的凭据
• TOKEN_ORACLE_BASE_URL：覆盖远程端点；默认为 https://mcp.guffeyholdings.com/TokenOracle
• TOKEN_ORACLE_SUBJECT：可选的最终用户主题转发为 X-Token-Oracle-Subject

其他桥接命令：

• npx -y token-oracle-mcp login：接受 --api-key 用于付费身份验证，或在未提供密钥时获取托管试用凭据
• npx -y token-oracle-mcp logout：删除本地存储的凭据

能力

工具：

• estimate_cost
• estimate_cost_batch
• compare_models
• budget_check
• find_cheapest_for_budget
• get_budget_status
• list_request_activity
• get_usage_summary
• get_usage_leaderboard

资源：

• token-oracle://meta
• token-oracle://models
• token-oracle://heuristics
• token-oracle://pricing/changelog

提示：

• cost_analysis_workflow

版本控制

• 托管服务版本： 1.0.6
• 桥接包版本： 1.0.6