Ratevert MCP

Ratevert MCP

Ratevert MCP 是一款公开、只读的 Model Context Protocol 服务，用于搜索和转换货币、股票、加密货币、ETF 和基金。它专为需要获取标准资产标识、精确实时汇率、可用时的数据源新鲜度，以及可供引用的 Ratevert URL 的 AI Agent 设计。

托管端点为：

https://ratevert.com/api/mcp

无需 API 密钥。公开使用受速率限制，单次比较请求最多可包含四项资产（一项源资产和三项目标资产）。

工具

工具	功能
search_assets	查找标准的 Ratevert 货币、股票、ETF、基金或加密货币资产。
get_rate	返回两项资产的当前单位汇率及标准配对 URL。
convert_amount	转换指定金额，并返回精确汇率、四舍五入后的显示值、数据新鲜度和来源 URL。
compare_assets	在单次请求中比较一项源资产和最多三项目标资产。

连接 Agent

在任何兼容 MCP 的客户端中使用同一个远程 Streamable HTTP 端点。

Claude Code

claude mcp add --transport http ratevert https://ratevert.com/api/mcp

ChatGPT、Codex、OpenClaw 和 Hermes

在客户端配置中添加远程 HTTP MCP 服务，将其命名为 Ratevert，并将 URL 设为 https://ratevert.com/api/mcp。ChatGPT 是否可用取决于账号和 OpenAI 提供的开发者模式功能；Ratevert 并未作为 ChatGPT 商店插件发布。

官方 MCP Registry 条目为 com.ratevert/mcp。请将其用作公开分发渠道；托管的 Streamable HTTP URL 仍为 https://ratevert.com/api/mcp。

面向用户的文档和连接指南：ratevert.com/mcp。

本地运行

要求：

• Node.js 20 或更高版本
• npm 10 或更高版本

npm ci
cp .env.example .env
npm start

服务默认绑定到 127.0.0.1:3010，并开放 http://127.0.0.1:3010/mcp。它会通过 RATEVERT_MCP_API_BASE_URL 获取 Ratevert 公共 API 数据。如果将服务部署在反向代理后，请将 RATEVERT_MCP_TRUST_PROXY 限定为已知代理，并在代理边界处覆盖传入的转发标头。

验证

npm test
npm run verify:release
npm pack --dry-run

对于已部署的端点：

RATEVERT_MCP_TEST_URL=https://ratevert.com/api/mcp npm run smoke

生产环境中请勿启用可选的速率限制循环，除非使用单独的测试地址：该循环会有意重复发送请求。

数据和限制

Ratevert MCP 仅用于提供信息且为只读服务。市场数据可能会延迟或不可用。如果上游资产数据提供相关信息，结果会包含检索时间戳和数据源新鲜度。本服务不构成投资、交易、税务或支付建议。

安全

请参阅 SECURITY.md，了解私密漏洞报告指南。