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 分

    请在仓库或注册中心条目中声明许可证。