CurrencyCore

CurrencyCore MCP

MCP に対応したあらゆる AI クライアントを、ホスト型 MCP サーバー https://mcp.currency-core.com/mcp 経由で CurrencyCore API に接続できます。リアルタイムの FX レート、任意の通貨ペアの通貨換算、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 — 指定年における 1 か国の 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" }
  }
}

同じエージェントに 2 つの名前があります。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 ではストリーミング可能な HTTP に httpUrl を使用します）。

{
  "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、…）

OAuth を使用する標準的な リモートのストリーミング可能 HTTP MCP サーバーです。クライアントの MCP 設定で https://mcp.currency-core.com/mcp を指定し、初回使用時にブラウザーでサインインしてください。

ℹ️ ワンクリックのディープリンク方式（Cursor ／ VS Code）やクライアントごとの設定キーは、変更されることがあります。ディープリンクがうまく動作しない場合は、安定している手動の JSON スニペットを使用してください。

---

レジストリへの公開・掲載

• 公式 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 がビルド・ホストするサーバー向けです。ホスト済みのリモートサーバーは UI から追加します）。
• ディレクトリ — 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 を省略します。
• 接続時に適切な組織を選択してください — 接続先は 1 つの組織に紐づいており、切り替えるには再接続が必要です。使用量・制限・請求は、通常の API キーと同じように、その組織に適用されます。
• いつでも無効にできます — CurrencyCore ダッシュボードの Developer → MCP server) で組織の MCP を無効にすると、何も取り消さずに MCP の通信を停止できます。
• 自然言語で質問してください — たとえば、「250 USD を EUR と INR に換算して。ドイツとインドの購買力平価で調整して」 や 「同じ買い物かごなら、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 を更新し（マーケットプレイスのエントリー、server.json、gemini-extension.json も更新）、コミットして main にプッシュします。インストール済みの Claude Code / Gemini ユーザーには更新が反映されます。レジストリのバージョンを更新するには、server.json を再公開してください。

---

セルフホストや API 自体については、https://currency-core.com と API ドキュメントをご覧ください。MCP サーバーはパブリック API の薄いプロキシです。すべての呼び出しに同じ認証、レート制限、請求が適用されます。

ライセンス

MIT — LICENSE をご覧ください。