CurrencyCore

CurrencyCore MCP

将任何支持 MCP 的 AI 客户端连接到 CurrencyCore API，通过托管的 MCP 服务 https://mcp.currency-core.com/mcp 获取实时外汇汇率、任意货币对转换、PPP（购买力平价）调整、历史趋势和风险分析，以及国家／货币参考数据。

此代码库既是 Claude Code 插件 + 市场，也是供其他客户端／注册表使用的一组清单文件，它们都指向同一个远程服务。

• 网站： https://currency-core.com
• 文档： https://currency-core.com/docs/mcp
• 服务： https://mcp.currency-core.com/mcp
• 版本： 1.0.0

可用功能

公共参考工具——无需身份验证

• list_countries — 支持的国家及其官方货币
• list_currencies — 支持的 ISO 4217 代码、名称和符号

核心工具——授权连接，适用于所有套餐

• convert — 转换不同货币之间的金额，可选择按 PPP 调整（PPP 格式示例：from=USD:USA&to=INR:IND）
• get_rates — 指定日期的完整 USD 基准汇率快照
• get_rates_by_base — 将汇率快照转换为以任意基础货币为基准
• get_history — 历史汇率时间序列（免费套餐：最近 30 天；付费套餐：完整历史数据）
• get_ppp_factor — 某个国家某一年度的 IMF PPP 单一换算因子

分析工具——适用于 Growth 套餐或更高级别

• analyze_history — 趋势、比较、涨跌幅、变化百分比、波动率、最高／最低值、趋势序列
• analyze_ppp — IMF PPP 因子的变化及其随时间的趋势
• analyze_volatility — 按年化波动率对货币进行排名或比较
• analyze_correlation — 货币走势的关联程度
• analyze_drawdown — 从峰值到谷值的跌幅及恢复速度
• analyze_safe_haven — 避险评分和排名
• analyze_mean_reversion — 货币回归历史均值的力度

资源 — CurrencyCore API 文档和 OpenAPI 3.1 规范，可在客户端内阅读。 提示词 — 引导式工作流（使用 PPP 转换、比较生活成本、生成汇率表、解释错误）。

服务使用 OAuth：首次连接时，客户端会在浏览器中打开页面，让你登录 CurrencyCore 并选择一个组织。之后的调用会计入该组织的套餐用量（你也可以随时在控制面板中按组织停用 MCP）。

---

在客户端中安装

Claude Code

claude plugin marketplace add CurrencyCore/currency-core-mcp
claude plugin install currency-core-mcp@currencycore
# in a session: /mcp → currency-core → Authenticate

Oh My Pi (omp)

omp 兼容 Claude Code 市场，因此可以直接从此代码库安装同一插件：

omp plugin marketplace add CurrencyCore/currency-core-mcp
omp plugin install currency-core-mcp@currencycore
# first use opens a browser sign-in (or run: /mcp reauth currency-core)

…也可以添加到 .omp/mcp.json（项目）／~/.omp/agent/mcp.json（用户）中——omp 需要 "type": "http"：

{
  "mcpServers": {
    "currency-core": { "type": "http", "url": "https://mcp.currency-core.com/mcp" }
  }
}

同一个 Agent，两种名称：pi 系列和 omp CLI 共用此配置（PI_PROFILE / OMP_PROFILE）；没有单独的 .pi 路径。

Cursor

一键安装：添加到 Cursor

…也可以添加到 .cursor/mcp.json（项目）／Cursor Settings → MCP：

{
  "mcpServers": {
    "currency-core": { "url": "https://mcp.currency-core.com/mcp" }
  }
}

VS Code（Copilot / MCP）

添加到 .vscode/mcp.json（或用户 settings.json 中的 "mcp"）：

{
  "servers": {
    "currency-core": { "type": "http", "url": "https://mcp.currency-core.com/mcp" }
  }
}

Gemini CLI

作为扩展安装（会从此代码库读取 gemini-extension.json）：

gemini extensions install https://github.com/CurrencyCore/currency-core-mcp

…也可以添加到 ~/.gemini/settings.json（Gemini 使用 httpUrl 进行可流式 HTTP 连接）：

{
  "mcpServers": {
    "currency-core": { "httpUrl": "https://mcp.currency-core.com/mcp" }
  }
}

GitHub Copilot CLI

在 Copilot CLI 的 MCP 配置中使用 URL https://mcp.currency-core.com/mcp 注册服务（HTTP 传输）。请查阅当前 Copilot CLI 的 MCP 文档，确认确切的配置路径——服务本身完全兼容。

任何其他 MCP 客户端（Claude Desktop、Cline、Continue、Zed 等）

这是一个标准的 远程、可流式 HTTP MCP 服务，使用 OAuth。将客户端的 MCP 配置指向 https://mcp.currency-core.com/mcp，并在首次使用时完成浏览器登录。

ℹ️ 一键深层链接方案（Cursor / VS Code）和各客户端的配置键偶尔会变化——如果深层链接无法正常工作，请使用手动 JSON 代码段；它是稳定的。

---

在注册表中发布 / 列出

• Official MCP Registry（registry.modelcontextprotocol.io）——仅远程服务，使用官方 mcp-publisher CLI 发布 server.json：

  # Install (macOS): brew install mcp-publisher
  # Or download the release binary from github.com/modelcontextprotocol/registry/releases
  mcp-publisher validate
  mcp-publisher login github
  mcp-publisher publish
  

  GitHub 身份验证会验证 io.github.CurrencyCore 命名空间；仅远程服务无需 npm 包。
• Smithery（smithery.ai）——通过 Smithery 网站提交远程服务（其基于代码仓库的配置适用于由 Smithery 构建 / 托管的服务；托管的远程服务通过其界面添加）。
• 目录——在 Glama（glama.ai/mcp）、mcp.so、PulseMCP 中列出，并向 awesome-mcp-servers 提交 PR。
• Claude.ai / Claude Desktop 连接器——将远程服务提交到 Anthropic 的连接器目录（这正是它所需的远程 OAuth 形式）。

---

使用提示

• PPP 转换时，每种货币都必须指定国家：传入 from=USD:USA 和 to=INR:IND（仅凭货币无法推断国家）。amount 默认为 1，因此省略它即可获取原始汇率。
• 日期均为 UTC，且不能是未来日期；省略 date 即可获取最新快照。
• 连接时选择正确的组织——连接会绑定到一个组织；切换组织需要重新连接。用量 / 限额 / 账单与普通 API 密钥完全相同，均适用于该组织。
• 随时关闭——在 CurrencyCore 控制面板中为某个组织停用 MCP（Developer → MCP server），即可停止 MCP 流量，无需撤销任何内容。
• 用自然语言提问——例如 “将 250 USD 转换为 EUR 和 INR，并按德国和印度进行 PPP 调整”，或 “购买同一篮子商品，USA 还是 India 更便宜？”——模型会选择合适的工具。

---

仓库结构

.
├── .claude-plugin/
│   └── marketplace.json          # Claude Code marketplace (lists the plugin)
├── currency-core-mcp/
│   └── .claude-plugin/
│       └── plugin.json           # Claude Code plugin (inline mcpServers, type: http)
├── server.json                   # Official MCP Registry manifest
├── gemini-extension.json         # Gemini CLI extension manifest
├── glama.json                    # Glama ownership/claim metadata
└── README.md

更新

在 currency-core-mcp/.claude-plugin/plugin.json 中更新 version（以及 marketplace 条目、server.json、gemini-extension.json），提交并推送到 main。已安装的 Claude Code / Gemini 用户会收到更新；若要发布新的注册表版本，请重新发布 server.json。

---

要自托管或了解 API 本身？请参阅 https://currency-core.com 和 API 文档。MCP 服务是公共 API 的轻量代理——每次调用都会遵循相同的身份验证、速率限制和计费规则。

许可证

MIT——请参阅 LICENSE。