内容
# Ratevert MCP
Ratevert MCP 是一个公开的、只读的[模型上下文协议](https://modelcontextprotocol.io/)服务器，用于搜索和转换货币、股票、加密货币、ETF 和基金。它专为需要规范化资产标识、精确当前转换、源新鲜度（当可用时）以及可引用的 Ratevert URL 的 AI 代理而设计。
托管的端点是：
```text
https://ratevert.com/api/mcp
```
它不需要 API 密钥。公共使用有速率限制，一个比较请求最多可以包含四个资产（一个源资产和三个目标资产）。
## 工具
| 工具 | 功能描述 |
| --- | --- |
| `search_assets` | 查找规范的 Ratevert 货币、股票、ETF、基金或加密货币资产。 |
| `get_rate` | 返回两个资产的当前一单位汇率，带有规范的配对 URL。 |
| `convert_amount` | 转换指定的金额，返回精确的汇率、舍入后的显示值、新鲜度和源 URL。 |
| `compare_assets` | 在一个请求中比较一个源资产和最多三个目标资产。 |
## 连接代理
在任何兼容 MCP 的客户端中使用相同的远程 Streamable HTTP 端点。
### Claude 代码
```bash
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 商店插件发布。
人类文档和连接指南：[ratevert.com/mcp](https://ratevert.com/mcp)。
## 本地运行
要求：
- Node.js 20 或更新版本
- npm 10 或更新版本
```bash
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` 限制为已知的代理，并在代理边界处重写传入的转发头。
## 验证
```bash
npm test
npm run verify:release
npm pack --dry-run
```
对于已部署的端点：
```bash
RATEVERT_MCP_TEST_URL=https://ratevert.com/api/mcp npm run smoke
```
在生产环境中，请勿在不使用单独的测试地址的情况下启用可选的速率限制循环：它故意发送重复的请求。
## 数据和限制
Ratevert MCP 是信息性的，只读的。市场数据可能会延迟或不可用。结果包括检索时间戳和源新鲜度（当上游资产数据公开时）。该服务不是投资、交易、税务或支付建议。
## 安全
参见 [SECURITY.md](SECURITY.md) 以获取私有漏洞报告指南。
