Frankfurter

io.github.lineofflight由 GitHub 帳號 lineofflight 發布v0.5.4更新於 Nov 7, 2026

Convert currencies and fetch blended FX rates from 50+ institutional sources.

已驗證Streamable HTTP可網頁執行金融資料與分析

概覽

AI 產生的概覽

Frankfurter 官方 MCP 伺服器,用於貨幣換算以及取得混合或指定機構的外匯參考匯率。

可以做什麼
  • 在兩種貨幣之間換算金額,可指定歷史日期或採用某家機構公布的匯率
  • 取得最新或單日參考匯率,可指定基準貨幣、報價貨幣清單以及一家或多家機構進行比較
  • 列出支援的貨幣、貴金屬與加密資產代碼及其名稱
  • 列出所轉送的機構,含鍵名、匯率類型、頻率與涵蓋日期
適用情境
適合需要快速貨幣換算、每日外匯參考匯率,或需要可引用的某家央行或財政部公布匯率(例如稅務、海關申報)的情境。
執行需求
無需安裝:提供託管的遠端端點,未宣告任何身分驗證、金鑰或環境變數。自行架設需要 Node.js 與 npm,或使用 Docker;可選的 PORT 與 FRANKFURTER_API_URL 僅適用於自架實例。
安裝前請注意
匯率為每日參考匯率,並非即時交易匯率,專案聲明不構成財務建議。換算結果依目標貨幣最小單位四捨五入,上游依方向分別取整,低價值貨幣換算可能損失精度。時間序列或批次查詢需改用其 REST API。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Frankfurter,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.lineofflight%2Ffrankfurter/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "frankfurter": {
      "type": "http",
      "url": "https://mcp.frankfurter.dev/"
    }
  }
}

README

frankfurter-mcp

Official Model Context Protocol server for the Frankfurter exchange-rate API. A thin, stateless proxy over Frankfurter's v2 blended multi-source reference rates.

Tools

  • convert — the primary tool. Convert an amount between two currencies; returns a money object { amount, currency } rounded to the target's minor units. Pass date for a historical rate, provider for one institution's published rate (e.g. UST, the U.S. Treasury's quarterly reporting rate).
  • get_rates — blended reference rates for the latest day or a single date. Optional base, quotes and provider (or providers to compare multiple institutions). The raw-rate companion to convert; with provider and the provider's own base, the digits are as published, with the date they took effect.
  • list_currencies — supported currency, precious metal and crypto asset codes and names as { code: name }.
  • list_providers — the institutions relayed, with key, rate type, frequency and coverage dates, to pick a provider.

For time series, historical ranges, or bulk queries, use the REST API at https://api.frankfurter.dev/v2 directly.

Rates are daily reference rates, not real-time trading rates. Not financial advice.

Run

bash
npm installnpm run buildnpm start            # listens on :3000, POST /

Docker:

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

The prebuilt ghcr.io/lineofflight/frankfurter-mcp:latest image is published on each release; building from source also works.

Point any MCP client at http://<host>:3000/ (Streamable HTTP). The hosted server is at https://mcp.frankfurter.dev/.

Configuration

  • PORT — HTTP port (default 3000).
  • FRANKFURTER_API_URL — upstream API base (default https://api.frankfurter.dev). Set this to a self-hosted Frankfurter instance if desired. The value must be a host root: any path prefix in it is discarded (e.g. https://example.com/api resolves to https://example.com/v2/rates), so a self-hosted instance must be reachable at the host root.

Development

bash
npm test       # vitestnpm run lint   # biome

License

MIT

來源:README.md,提交 90b1343

工具

4

get_rates

Get exchange rates

Latest or a single day's exchange rates. The raw-rate companion to `convert`. With `provider`, published rates from one or more institutions: on its own base the digits are as published, with the date they took effect.

輸入參數basedatequotesproviderproviders

convert

Convert currency

Convert an amount from one currency to another. Returns {amount, currency} rounded to the target's minor units. Upstream rounds rates per direction; for low-value sources, flip via `get_rates` for more precision. Pass `provider` to use one institution's published rate, e.g. UST for a U.S. Treasury reporting rate.

輸入參數to必填datefrom必填amount必填provider

list_currencies

List currencies

List all supported currency, precious metal and crypto asset codes and their full names (e.g. { 'USD': 'United States Dollar' }).

無需輸入參數。

list_providers

List providers

List the institutions whose rates Frankfurter relays, with key, rate type, frequency (daily, weekly, monthly or quarterly) and coverage dates. Use a key as `provider` in `convert` or `get_rates` for that institution's published rates instead of the blend.

無需輸入參數。

版本歷史

5
  1. v0.5.4最新Nov 7, 2026
  2. v0.5.3Nov 3, 2026
  3. v0.5.2Oct 23, 2026
  4. v0.5.1Sep 17, 2026
  5. v0.5.0Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。