有問題或遇到狀況?歡迎至 GitHub Discussions 發問。

透過官方 Model Context Protocol 伺服器,直接從 AI 助理換算貨幣並查詢最新或歷史匯率。歷史資料可追溯至 1948 年。

將 https://mcp.frankfurter.dev/ 新增為遠端 HTTP 伺服器即可使用,無須 API 金鑰或註冊帳號。

安裝設定

  1. 開啟 Settings,接著選擇 Apps(或 Connectors)。
  2. 點選右上角的 Advanced settings,並啟用 Developer mode 以允許自訂應用程式。
  3. 返回 Apps 子選單,點選 Create app(或 Create connector)。
  4. 輸入端點 URL:https://mcp.frankfurter.dev/。
  5. 在驗證方式(Authentication)中選擇 None。

在 Claude Code 中:

claude mcp add frankfurter https://mcp.frankfurter.dev/

在 Claude Desktop 或 Claude.ai 中:

  1. 開啟 Settings,接著選擇 Connectors。
  2. 點選 Add custom connector。
  3. 輸入端點 URL:https://mcp.frankfurter.dev/。
  4. 點選 Add 完成設定。連線成功後,在對話介面中開啟該連接器即可。

加入你的 MCP 設定檔(Cursor、Windsurf、VS Code 等):

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

可用工具

連線後,你的 AI 助理即可呼叫以下工具:

convert
在兩種貨幣之間換算金額,回傳換算結果與匯率。
參數:
  • amount(數值,必填):欲換算的金額。
  • from(字串,必填):三碼基準 ISO 貨幣代碼(例如 USD)。
  • to(字串,必填):三碼目標 ISO 貨幣代碼(例如 EUR)。
  • date(字串,選填):指定日期 YYYY-MM-DD 以進行歷史匯率換算。
  • provider(字串,選填):資料來源代碼,改用單一機構公布的匯率而非綜合匯率。例如 UST 為美國財政部每季申報匯率,傳入該季內任一日期會回傳當期有效匯率。
get_rates
查詢參考匯率。
參數:
  • date(字串,選填):匯率日期 YYYY-MM-DD(預設為最新匯率)。
  • base(字串,選填):三碼基準貨幣代碼(預設為 EUR)。
  • quotes(字串或陣列,選填):依貨幣代碼篩選結果。
  • provider / providers(字串或陣列,選填):一或多個資料來源代碼。以該來源自身的基準貨幣查詢時,會原樣回傳原始公布數值與生效日期。
list_currencies
列出所有支援的 ISO 4217 貨幣代碼與名稱。
list_providers
列出所有資料來源及其代碼、匯率類型、更新頻率與涵蓋期間,方便挑選 provider。

若需要時間序列、歷史區間或批次資料下載,請直接使用 REST API。