{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_st9xwh9zhmh2","handle":"mcp-exchange-master","url":"https://wellknown.network/agents/mcp-exchange-master","links":{"self":"https://wellknown.network/agents/mcp-exchange-master/record.json","html":"https://wellknown.network/agents/mcp-exchange-master","markdown":"https://wellknown.network/agents/mcp-exchange-master/record.md","api":"https://wellknown.network/api/v1/agents/mcp-exchange-master","status":"https://wellknown.network/api/v1/agents/mcp-exchange-master/status","claim":"https://wellknown.network/agents/mcp-exchange-master/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-exchange-master/claim.json","badge":"https://wellknown.network/agents/mcp-exchange-master/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-exchange-master/history","tools":"https://wellknown.network/api/v1/agents/mcp-exchange-master/tools"},"ard":{"identifier":"urn:air::server:mcp-exchange-master","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-exchange-master","summary":"汇率全能 MCP Server — 实时汇率/留学预算/跨境定价/结汇建议, 支持28种货币","description":"# 💱 mcp-exchange-master\n\n**汇率全能 MCP Server** — 实时汇率查询、留学预算、跨境电商定价、结汇时机建议，一个 Server 全搞定。\n\n合并自 4 个扣子技能：汇率精算师 / 汇率计算 / 留学汇率精算师 / 跨境电商汇率卫士。\n\n数据源：[TianAPI](https://www.tianapi.com/) 中国银行外汇牌价，支持 28 种主流货币。\n\n---\n\n## 🛠 工具列表\n\n| 工具 | 功能 | 典型场景 |\n|------|------|---------|\n| `exchange_rate` | 实时汇率查询 + 双向换算 | \"美元兑人民币多少\" \"1000英镑换多少人民币\" |\n| `exchange_history` | 历史汇率走势 + 趋势判断 | \"最近美元走势如何\" \"欧元涨还是跌\" |\n| `study_abroad_budget` | 留学费用预算 + 汇率换算 | \"美国留学一年要多少钱\" \"5万美元学费换多少人民币\" |\n| `cross_border_pricing` | 跨境电商多站点定价 | \"成本50元的产品在美国站卖多少\" |\n| `settlement_advice` | 结汇时机建议 | \"有1万美元要结汇,现在合适吗\" |\n\n---\n\n## 📦 安装\n\n```bash\npip install mcp-exchange-master\n```\n\n或从源码安装：\n\n```bash\ngit clone https://github.com/yourname/mcp-exchange-master.git\ncd mcp-exchange-master\npip install -e .\n```\n\n## ⚙️ 配置\n\n需要 [TianAPI](https://www.tianapi.com/) API 密钥（免费注册即得）：\n\n```bash\nexport TIANAPI_KEY=\"your_api_key_here\"\n```\n\n## 🚀 使用\n\n### 命令行\n\n```bash\n# STDIO 模式 (默认)\nmcp-exchange-master\n\n# 或\npython -m mcp_exchange_master\n```\n\n### MCP 客户端配置\n\n在 Claude Desktop / Cherry Studio / ChatBox 等 MCP 客户端中添加：\n\n```json\n{\n  \"mcpServers\": {\n    \"exchange-master\": {\n      \"command\": \"mcp-exchange-master\",\n      \"env\": {\n        \"TIANAPI_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### 开发测试\n\n```bash\n# 安装 FastMCP CLI\npip install \"mcp[cli]\"\n\n# 交互式测试\nmcp dev src/mcp_exchange_master/server.py\n\n# 检查工具列表\nmcp inspect src/mcp_exchange_master/server.py\n```\n\n## 💡 工具详细说明\n\n### exchange_rate — 实时汇率 + 换算\n\n```python\n# 查汇率\nexchange_rate(from_currency=\"USD\", to_currency=\"CNY\")\n\n# 换算金额\nexchange_rate(from_currency=\"USD\", to_currency=\"CNY\", amount=5000)\n\n# 双向汇率\nexchange_rate(from_currency=\"美元\", to_currency=\"人民币\", bidirectional=True)\n```\n\n支持口语化输入：美元/美金/刀/英镑/人民币/块 等。\n\n### study_abroad_budget — 留学预算\n\n```python\nstudy_abroad_budget(\n    target_country=\"美国\",\n    tuition=50000,\n    tuition_currency=\"USD\",\n    living_cost_monthly=2000,\n    duration_years=2,\n    home_currency=\"CNY\"\n)\n```\n\n返回学费/生活费换算、年度预算、汇率波动风险区间。\n\n### cross_border_pricing — 跨境定价\n\n```python\ncross_bord…","publisher":{"name":"Exchange Master Team","url":null},"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["cross-border","currency","exchange-rate","forex","mcp","study-abroad"],"pricing":null,"endpoints":[{"url":"pypi:mcp-exchange-master","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"finance.markets","name":"Markets & Trading","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev","finance"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-exchange-master","registry":"pypi","observedAt":"2026-11-03T13:26:36.728Z","publishedAt":"2026-05-17T08:18:43.544279Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-exchange-master","url":"https://pypi.org/project/mcp-exchange-master/","firstSeenAt":"2026-09-10T01:20:32.724Z","fetchedAt":"2026-11-03T13:25:03.062Z","normalizedAt":"2026-11-03T13:25:03.062Z"}]},"firstSeenAt":"2026-09-10T01:20:32.724Z","updatedAt":"2026-11-03T13:26:36.728Z"}