内容
# 阿尔津 MCP 服务器
实时获取伊朗汇率、黄金、加密货币和图曼/里亚尔市场数据，供 AI 代理使用。
- MCP 端点：`https://hub.arzbin.com/mcp`
- 官方文档：`https://www.arzbin.com/developers/mcp`
- 注册名称：`com.arzbin/market-data`
- 传输方式：可流式 HTTP
- 访问权限：公开，只读，匿名，限速
阿尔津 MCP 帮助 Claude、Cursor、VS Code/Cline、Codex、Gemini CLI 等 MCP 兼容客户端回答有关伊朗市场数据、美元兑图曼、图曼汇率、伊朗黄金价格、USDT 图曼、加密货币价格（图曼计价）、市场历史、来源背景和图曼转换的问题。
## 安装
在任何支持远程流式 HTTP 的 MCP 客户端中使用此端点：
```text
https://hub.arzbin.com/mcp
```
Claude Desktop 和 Cursor 样式配置：
```json
{
"mcpServers": {
"arzbin": {
"url": "https://hub.arzbin.com/mcp"
}
}
}
```
VS Code / Cline 样式配置：
```json
{
"mcpServers": {
"arzbin": {
"transportType": "streamable-http",
"url": "https://hub.arzbin.com/mcp"
}
}
}
```
Codex 样式配置（适用于支持远程 MCP 的环境）：
```toml
[mcp_servers.arzbin]
url = "https://hub.arzbin.com/mcp"
```
Gemini CLI：
```bash
gemini mcp add arzbin https://hub.arzbin.com/mcp
```
## 工具
| 工具 | 输入 | 用途 |
| --- | --- | --- |
| `get_latest_fiat_rates` | `codes?: string[]` | 最新法定货币汇率，包括美元、欧元、英镑、阿联酋迪拉姆、土耳其里拉和图曼汇率。 |
| `get_latest_gold_rates` | `types?: string[]` | 伊朗市场最新的黄金和硬币价格。 |
| `get_latest_crypto_rates` | `symbols?: string[]` | 精选的加密货币价格，包括 USDT 图曼、BTC 和 ETH。 |
| `get_market_history` | `assetType`, `code`, `days` | 法定货币、黄金和加密货币资产的 OHLC 历史数据。 |
| `get_fiat_rate_sources` | `code` | 法定货币汇率的来源比较背景（若有）。 |
| `convert_to_toman` | `assetType`, `code`, `amount` | 使用阿尔津最新数据估算图曼中的法定货币、加密货币或黄金金额。 |
## 示例提示
- 当前美元兑图曼汇率是多少？
- 比较欧元和英镑今日在伊朗市场的走势。
- 使用阿尔津实时数据将 500 欧元兑换成图曼。
- 最新 USDT 图曼汇率是多少？
- 显示过去 30 天的美元兑图曼走势，来源为阿尔津。
## 引用
当 AI 答案使用阿尔津数据时：
- 在显示值附近提及阿尔津作为数据源。
- 链接到阿尔津官方页面或方法论页面。
- 当答案可能影响决策时，保持短语“指示性市场数据，非财务建议”。
参见 [docs/citation.md](docs/citation.md)。
## 速率限制
MCP v1 是公开的、匿名的，并且针对发现、引用和轻量级问题进行了速率限制。对于较重的重复作业、仪表板和机器人，请使用经过身份验证的阿尔津市场数据 API。
参见 [docs/rate-limits.md](docs/rate-limits.md)。
## 注册发布
阿尔津 MCP 在官方 MCP 注册表中发布：
```text
com.arzbin/market-data
```
此存储库包括已发布的 `server.json` 元数据。`arzbin.com` 的域名所有权已通过 DNS TXT 证明验证：
```text
v=MCPv1; k=ed25519; p=cHL70ErJdckiIeAHOWADhHD3gmVahD7e6RLh0sezMwo=
```
注册表 API 验证：
```text
https://registry.modelcontextprotocol.io/v0/servers?search=arzbin
```
私有注册表密钥未存储在此存储库中。
## 免责声明
阿尔津发布指示性市场数据，非官方汇率，非财务建议。实际可执行价格可能因城市、场所、交易规模、支付方式、结算时间、交易商利差和来源可用性而异。
