货币汇率API工具

法兰克福MCP

法兰克福香肠 是一个有用的API，用于欧洲中央银行等来源发布的最新货币汇率、历史数据或时间序列。如果您必须访问Frankfurter API作为通过模型上下文协议（MCP）公开的语言模型代理的工具，则您需要FrankfurterMCP。

安装

如果您的目标是使用此MCP服务器上可用的工具，请参阅下面的用法>客户端小节.

克隆此存储库的目录将称为 工作目录 或 西部数据 在下文中。

安装 只是 管理项目任务。

安装 紫外线。若要在虚拟环境中安装依赖关系最小的项目，请运行 just install 在 西部数据。安装所有非必需的依赖项(这些是开发和测试所必需的)，跑 just install-all 相反。

环境变量

以下是可用于配置应用程序的环境变量列表。文件中提供了环境变量模板 .env.template. 请注意，下表中列出的默认值并不总是与 .env.template 文件.

可以指定以下环境变量，前缀为 FASTMCP_: HOST, PORT, DEBUG 和 LOG_LEVEL.

底层HTTP客户端还尊重一些环境变量，如中所述 HTTPX库此外， SSL_CERT_FILE 和 SSL_CERT_DIR 可以配置为使用托管API端点或中间HTTP（S）代理服务器的自签名证书。

法兰克福MCP将缓存对法兰克福API的调用，以提高性能。缓存有两种不同的策略。对于响应对于某些参数（例如历史速率查找）不变的API调用，使用最近最少使用（LRU）缓存。对于响应确实发生变化的API调用，例如最新速率查找，使用生存时间（TTL）缓存，默认生存时间设置为15分钟。可以使用环境变量调整缓存参数，见下文。

用法

以下小节说明了如何将法兰克福MCP作为服务器运行，以及如何从MCP客户端访问它。

服务器

在运行服务器时，您可以选择使用 stdio 传输或HTTP选项(sse 或更新的 streamable-http).

使用默认设置和 MCP_SERVER_TRANSPORT 着手 sse 或 streamable-http，MCP端点将通过HTTP在 http://localhost:8000/sse 用于服务器发送事件（SSE）传输，或 http://localhost:8000/mcp 用于流式HTTP传输。

如果你想运行法兰克福MCP stdio 传输和默认参数，在不使用的情况下执行以下命令 .env.template 文件。

服务器与 uv

可选的：复制 .env.template 文件到a .env 文件在 西部数据，如果您想使用默认设置以外的任何设置，则可以修改上述环境变量。或者，在shell上，您可以导出要修改的环境变量。

在中运行以下命令 西部数据 启动MCP服务器。

uv run frankfurtermcp

服务器与 pip 来自PyPI包

使用以下命令从PyPI添加此包 pip 在虚拟环境中（可能由 uv, pyenv 或 conda)然后通过运行以下命令启动服务器。

可选的：添加a .env 包含以下内容的文件 .env.template 如果您想修改上述环境变量的默认值，请使用文件。或者，在shell上，您可以导出要修改的环境变量。

pip install frankfurtermcp
python -m frankfurtermcp.server

使用Docker的服务器

此存储库中提供了一个Dockerfile， local.dockerfile，用于将法兰克福MCP服务器装入集装箱。首先，复制一份 .env.template 到一个 .env 文件。然后，修改以下变量 .env 文件需要。

• FASTMCP_HOST：设置为 0.0.0.0 以允许外部进入容器。 这仅用于本地测试，不建议用于生产部署.
• CORS_MIDDLEWARE_ALLOW_ORIGINS：设置为 * 以允许从任何来源对MCP服务器进行外部访问。 如果您想通过HTTP传输使用MCP Inspector测试服务器，则需要这样做，不建议用于生产部署.

要构建镜像，请创建容器并使用Docker Compose启动它，在中运行以下命令 西部数据.

如果您将端口更改为8000以外的任何端口 .env, 请记住更改中的端口号 docker-compose.yml.

备注所需的Docker Compose最低版本为2.24.0。您可以通过运行以下命令来检查您的版本 docker compose version。如果您有旧版本，请更新Docker Desktop以获取最新的Docker Compose。此外，后端必须支持BuildKit。

docker compose up --build

要在分离模式（背景）下运行，请添加 -d 标志：

docker compose up -d --build

要停止容器：

docker compose down

若要运行容器并使用本地Frankfurter API服务器，请运行以下命令。附上 -d 标志以分离模式运行。检查 local_api.env.template 文件，以指定本地API服务器使用的可选环境变量。

备注：首次启动时，当地法兰克福API可能需要一些时间来获取更新的汇率。对于随后的运行，本地Frankfurter API将使用缓存的数据，并且应该更快地启动，尽管它仍然会获取最新的速率。

FRANKFURTER_API_URL=http://frankfurter_api:8080/v1 docker compose --profile local_api up --build frankfurtermcp frankfurter_api

停止使用创建的容器组 local_api profile，运行以下命令。

docker compose --profile local_api down

这 docker-compose.yml 该文件包括使用只读文件系统（在相关情况下）进行安全强化、删除功能和资源限制。

备注：本地API服务器是使用 法兰克福GitHub仓库，因此这可能是不稳定的。如果你想使用特定的提交，请更改 context 字段为 build 在...之下 frankfurter_api_base 在 docker-compose.yml 文件指向特定的提交哈希。， https://github.com/lineofflight/frankfurter.git#0b6dbd80716f5abe27e8759fc548b74d35fa82b9 使用commit 0b6dbd80716f5abe27e8759fc548b74d35fa82b9.

成功构建和容器启动后，MCP服务器将通过HTTP在以下位置可用 http://localhost:8000/sse 用于服务器发送事件（SSE）传输，或 http://localhost:8000/mcp 用于流式HTTP传输。如果您还启动本地Frankfurter API服务器，API端点将在 http://localhost:8080/v1.

云托管服务器

当前可用的云托管选项如下。

• FastMCP云：https://frankfurtermcp.fastmcp.app/mcp
• 格拉玛。人工智能：https://glama.ai/mcp/servers/@阿尼班巴苏/法兰克福

客户端访问

本小节解释了客户端连接和测试法兰克福MCP服务器的方法。

MCP官方目视检查员

这 MCP检查员 是一个 官方的 模型上下文协议工具，可供开发人员用于测试和调试MCP服务器。这是探索MCP服务器的最全面的方法。

要使用它，您必须安装Node.js。安装和管理的最佳方式 node 以及MCP检查器等软件包将使用 节点版本管理器（或， nvm).一旦你有 nvm 安装后，您可以安装和使用最新的长期发布版本 node 通过执行以下操作。

nvm install --lts
nvm use --lts

之后（安装并）通过执行以下步骤运行MCP检查器 西部数据.

npx @modelcontextprotocol/inspector uv run frankfurtermcp

这将在端口6274创建一个带有身份验证令牌的本地URL，您可以在浏览器上复制和浏览该URL。进入MCP检查器UI后，按 连接 连接到MCP服务器。此后，您可以探索服务器上可用的工具。

Claude Desktop、Visual Studio等

要运行的服务器条目 stdio 您可以在Claude Desktop、Visual Studio Code等系统中使用的传输如下。

{
    "command": "uv",
    "args": [
        "run",
        "frankfurtermcp"
    ]
}

或者，使用 uvx:

{
    "command": "uvx",
    "args": [
        "frankfurtermcp"
    ]
}

而不是拥有 frankfurtermcp 作为列表中的最后一项 args，您可能需要指定脚本的完整路径，例如。， 西部数据/.venv/bin/frankfurtermcp.同样，不使用 uv，您还可以使用以下JSON配置，并将路径正确替换为 python3.12例如，例如 西部数据/.venv/bin/python3.12.

{
    "command": "python3.12",
    "args": [
        "-m",
        "frankfurtermcp.server"
    ]
}

可用MCP功能列表

法兰克福MCP具有以下MCP功能。

工具

下表列出了FrankfurterMCP服务器公开的工具名称。此处显示的描述用于文档目的，可能与模型上下文协议上公开的实际描述不同。

为了简洁起见，下表中没有列出每个工具的必需和可选参数，但MCP客户端可以通过协议获得这些参数。

贡献

安装 prek。然后启用 prek 通过在 西部数据.

prek install

欢迎拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。

测试和覆盖

要运行提供的测试用例，请执行以下操作。添加旗帜 --capture=tee-sys 以显示进一步的控制台输出。

uv run --group test pytest tests/

调用 just test-coverage 运行所有测试并生成覆盖率报告，如下所示。如果运行了所有测试，生成的覆盖率报告可能如下。

---------------------------------------------------------------------------------------- benchmark: 2 tests ---------------------------------------------------------------------------------------
Name (time in ms)                         Min               Max              Mean            StdDev            Median               IQR            Outliers       OPS            Rounds  Iterations
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
test_get_historical_exchange_rates     4.4944 (1.0)      5.1512 (1.0)      4.7919 (1.0)      0.2460 (1.0)      4.7819 (1.0)      0.3249 (1.0)           2;0  208.6840 (1.0)           5           1
test_get_latest_exchange_rates         4.7937 (1.07)     5.6976 (1.11)     5.3257 (1.11)     0.3345 (1.36)     5.4182 (1.13)     0.3575 (1.10)          2;0  187.7702 (0.90)          5           1
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Legend:
  Outliers: 1 Standard Deviation from Mean; 1.5 IQR (InterQuartile Range) from 1st Quartile and 3rd Quartile.
  OPS: Operations Per Second, computed as 1 / Mean
=============================================================== 15 passed in 4.09s ===============================================================
Name    Stmts   Miss    Cover   Missing
---------------------------------------
TOTAL     265      0  100.00%

6 files skipped due to complete coverage.
Test coverage complete.

许可证

麻省理工学院.

安全注意事项

本节记录了漏洞扫描中与安全相关的发现，并为部署决策提供了背景。

Airtable漏洞扫描结果和基本原理

检查与安全相关的发现 Airtable漏洞扫描 （搜索 frankfurtermcp)下面，连同理论基础和反驳论点。

项目状态

项目的当前状态为 活跃的 截至本README的最后一次更新。看 更新日志 查看详细的更改列表。