mcpField
A
AI Price Index

AI Price Index

本地服务
roninforge.orgAI 与智能体06 天前更新
代码仓库访问官网

关于 AI Price Index

AI Price Index 是只读、本地运行且无需 API 密钥的 MCP 服务，为开发者和 Agent 查询 AI 模型 API 价格。它支持按历史日期查询，并返回来源链接和验证日期，便于引用价格数据。

主要功能

  1. 01查询当前模型价格
  2. 02按日期查询历史价格
  3. 03比较多个模型价格
  4. 04按用量估算费用
  5. 05列出模型及别名

适用场景

  1. 01核对某日适用的模型价格
  2. 02比较不同模型的输入与输出价格
  3. 03按令牌用量估算 API 费用

MCP 相关

通过 stdio 向 MCP 客户端提供五种只读工具，查询随 npm 依赖打包的本地数据集。结果包含来源链接、最近验证日期、置信度和数据许可署名。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "roninforge-ai-price-index": {
      "command": "npx",
      "args": [
        "-y",
        "ai-price-index-mcp"
      ]
    }
  }
}
启动命令npx -y ai-price-index-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmai-price-index-mcp0.1.2

工具

5

收录的工具列表 · 更新于 3 周前

参数类型必填说明
modelstring是模型 ID 或别名，例如 "claude-opus-4-8" 或 "gpt-4o"。
providerstring否可选的提供商 slug（例如 "openai"、"anthropic"），用于消除裸 ID 的歧义。

详细介绍

ai-price-index-mcp

RoninForge ai-price-index-mcp 是一个只读的 Model Context Protocol 服务，可查询某个 AI 模型在指定日期的 API 价格，并提供能够证明该价格的一手来源。它采用 MIT 许可证，完全在你的机器上运行，无需 API 密钥。

它是 RoninForge.org 的一部分。RoninForge.org 是一个独立的开源工作坊，持续记录 AI 开发者工具生态的带日期、可复现数据。它会将开放的 AI Price Index 数据集提供给任何 MCP 客户端， 包括 Claude Code 和 Cursor。

大多数定价工具会告诉 Agent 某个模型今天的费用。本工具还可以查询模型指定日期的费用，并返回一手来源 URL 以及该价格最近一次验证的日期，让 Agent 能够引用该数字。按时间点查询正是它的差异化之处。

  • 无需密钥、无需提示词、运行时无需联网。 带日期的数据集以内联形式打包在 ai-price-index 依赖项中。服务会在本地读取数据，不会给你的流量增加任何负担。
  • 只读。 它只查询价格，无法写入、配置或向外发起调用。
  • 便于引用。 每个结果都包含 source_url、last_validated、confidence 和 CC BY 4.0 署名文本。

安装

需要 Node.js 18 或更高版本。无需构建步骤，也无需 API 密钥。

npx -y ai-price-index-mcp

该命令会运行 stdio 服务；MCP 客户端会根据以下配置为你启动它。

客户端配置

将以下内容添加到 MCP 客户端配置中。该服务使用 stdio。

Claude Code（~/.claude.json 或项目中的 .mcp.json）和 Cursor（~/.cursor/mcp.json）使用相同的 mcpServers 结构：

{
  "mcpServers": {
    "ai-price-index": {
      "command": "npx",
      "args": ["-y", "ai-price-index-mcp"]
    }
  }
}

或者，使用 Claude Code 的 CLI：

claude mcp add ai-price-index -- npx -y ai-price-index-mcp

工具

所有工具都会以文本内容形式返回结构化 JSON。价格单位为 usd_per_mtok（每百万个 token 的美元价格）。 模型 ID 会通过数据集中的别名解析，因此短 ID 也能使用（例如，claude-opus-4-5 会解析为 claude-opus-4-5-20251101）。

工具参数返回值
current_pricemodel、provider?模型今日的输入／输出价格及其来源。
price_onmodel、date (YYYY-MM-DD)、provider?指定日期生效的价格（按时间点查询）。
comparemodels[]、date?同一日期下多个模型的输入／输出价格对比。
cost_from_usagemodel、tokens、date?、provider?某个时间点的 token 用量汇总对应的美元金额，包含缓存倍率。
list_modelsprovider?已知模型 ID（可选限定一个供应商），每个 ID 均附带其别名。

cost_from_usage 的 tokens 接受 input、output、cache_read、cache_write_5m、 cache_write_1h（均为可选，缺省值按 0 计算）。缓存读取价格为输入价格的 0.1 倍，缓存写入价格为 1.25 倍（5 分钟）或 2 倍（1 小时）。

传入 provider（例如 openai、anthropic、google），即可区分存在于多个供应商旗下的同名 ID。

示例结果

使用 { "model": "gpt-4", "date": "2024-01-01" } 调用 price_on：

{
  "query": "gpt-4",
  "provider": "openai",
  "model": "gpt-4",
  "date": "2024-01-01",
  "covered": true,
  "input": {
    "usd_per_mtok": 30,
    "unit": "usd_per_mtok",
    "effective_from": "2023-03-14",
    "effective_to": null,
    "last_validated": "2023-04-15",
    "confidence": "archived",
    "source_url": "https://web.archive.org/web/20230415223802/https://openai.com/pricing"
  },
  "output": { "usd_per_mtok": 60, "...": "..." },
  "provenance": {
    "dataset": "AI Price Index by RoninForge",
    "data_version": "2026-06-17",
    "license": "CC-BY-4.0",
    "attribution": "AI Price Index by RoninForge (https://roninforge.org/data/ai-price-index/), CC BY 4.0",
    "source": "https://roninforge.org/data/ai-price-index/"
  }
}

工作原理

本服务是 ai-price-index npm 库的轻量封装，该库以打包内联的形式提供带日期的数据集。本服务没有定价逻辑、独立数据层，也不会发起网络调用。结果中报告的数据版本，是已安装的 ai-price-index 固定使用的数据集版本。要获取更新的价格，请升级该依赖项。

数据许可证与署名

价格数据来自 AI Price Index，并采用 CC BY 4.0 许可证。发布任何基于这些数据的内容时，请注明来源：

AI Price Index by RoninForge (https://roninforge.org/data/ai-price-index/), CC BY 4.0.

本服务的代码采用 MIT 许可证（参见 LICENSE）。数据和工具的许可证信息由上游 ai-price-index 仓库跟踪。

Links

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。