Frankfurter

frankfurter-mcp

Frankfurter 為替レート API 向けの公式 Model Context Protocol サーバーです。Frankfurter の v2 ブレンド型マルチソース参照レートに対する、薄型でステートレスなプロキシです。

ツール

• convert — 主なツールです。2 つの通貨間で金額を変換し、対象通貨の最小単位に丸めた { amount, currency } のマネーオブジェクトを返します。過去のレートには date を、特定の機関が公表したレート（例：米国財務省の四半期報告レートである UST）には provider を指定します。
• get_rates — 最新日のブレンド型参照レート、または単一の date のレートを取得します。base、quotes、provider（または複数の機関を比較する場合は providers）を指定できます。convert に対応する生レートを取得するツールです。provider とその機関独自の基準通貨を指定すると、公表された数値と適用開始日をそのまま取得できます。
• list_currencies — 対応する ISO 4217 コードと名称を { code: name } として取得します。
• list_providers — 中継対象の機関について、キー、レート種別、頻度、対象期間を取得し、provider を選ぶ際に利用できます。

時系列、過去の期間、または一括クエリには、REST API の https://api.frankfurter.dev/v2 を直接使用してください。

レートは日次の参照レートであり、リアルタイムの取引レートではありません。金融上の助言ではありません。

実行

npm install
npm run build
npm start            # listens on :3000, POST /

Docker：

docker build -t frankfurter-mcp . && docker run -p 3000:3000 frankfurter-mcp
docker run -p 3000:3000 ghcr.io/lineofflight/frankfurter-mcp:latest

ビルド済みの ghcr.io/lineofflight/frankfurter-mcp:latest イメージは各リリース時に公開されます。ソースからのビルドも可能です。

任意の MCP クライアントから http://<host>:3000/（Streamable HTTP）に接続してください。ホスト型サーバーの URL は https://mcp.frankfurter.dev/ です。

設定

• PORT — HTTP ポート（デフォルトは 3000）。
• FRANKFURTER_API_URL — 上流 API のベース URL（デフォルトは https://api.frankfurter.dev）。必要に応じて、セルフホスト可能な Frankfurter インスタンスを指定できます。この値にはホストルートを指定する必要があります。パスプレフィックスはすべて破棄されます（例：https://example.com/api は https://example.com/v2/rates として解決されます）。そのため、セルフホストインスタンスにはホストルートからアクセスできる必要があります。

開発

npm test       # vitest
npm run lint   # biome

ライセンス

MIT