Frankfurtermcp

🚀 Frankfurter MCP

Frankfurter MCP 是一个用于访问 Frankfurter API 的工具，借助模型上下文协议（MCP）为语言模型代理提供服务。Frankfurter API 由欧洲央行等机构发布，可提供最新货币汇率、历史数据或时间序列等信息。

🚀 快速开始

如果你想使用此 MCP 服务器上的工具，请参考以下“使用说明 > 客户端”部分。

将克隆此仓库的目录称为“工作目录”（WD）。

安装依赖

安装 uv。若要在虚拟环境中以最少依赖安装项目，请在工作目录中运行以下命令。若要安装所有非必要依赖（开发和测试所需），请将以下命令中的 --no-dev 替换为 --all-groups。

uv sync --no-dev

配置环境变量

以下是可用于配置应用程序的环境变量列表，环境变量模板已在 .env.template 文件中提供。

可以指定以下以 FASTMCP_ 为前缀的环境变量：HOST、PORT、DEBUG 和 LOG_LEVEL。有关 FastMCP 的更多信息，请参阅 全局配置选项。请注意，以 on_duplicate_ 为前缀的环境变量选项将被忽略。

底层 HTTP 客户端也遵循一些环境变量，具体请参阅 HTTPX 库文档。此外，可以配置 SSL_CERT_FILE 和 SSL_CERT_DIR 以使用托管 API 端点或中间 HTTP(S) 代理服务器的自签名证书。

✨ 主要特性

• 支持多种货币汇率查询，包括最新汇率、历史汇率。
• 提供多种部署方式，如本地部署、Docker 部署、云托管部署。
• 支持动态挂载，可集成到自定义 MCP 服务器中。
• 提供命令行界面（CLI）和官方 MCP 可视化检查器，方便测试和调试。

📦 安装指南

安装依赖

uv sync --no-dev

配置环境变量

可根据需要修改 .env.template 文件中的环境变量，或在 shell 中导出要修改的环境变量。

💻 使用示例

启动服务器

使用 uv 启动服务器

uv run frankfurtermcp

使用 PyPI 包和 pip 启动服务器

pip install frankfurtermcp
python -m frankfurtermcp.server

使用 Docker 启动服务器

docker build -t frankfurtermcp -f local.dockerfile .
docker create -p 8000:8000/tcp --env-file .env.template --expose 8000 --name frankfurtermcp-container frankfurtermcp
docker start frankfurtermcp-container

客户端访问

使用官方 MCP 可视化检查器

nvm install --lts
nvm use --lts
npx @modelcontextprotocol/inspector uv run frankfurtermcp

使用 Claude Desktop、Visual Studio 等

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

📚 详细文档

可用工具列表

FrankfurterMCP 命令行界面（CLI）

uv run cli --help

MCP_SERVER_TRANSPORT=streamable-http uv run frankfurtermcp
uv run cli tools-info

uv sync --extra opt
uv run cli llamaindex-tools-list

🔧 技术细节

贡献代码

安装 pre-commit 和 ruff，并在工作目录中启用 pre-commit。

pre-commit install

测试

MCP_SERVER_TRANSPORT=streamable-http uv run --group test pytest tests/

📄 许可证

本项目采用 MIT 许可证。

项目状态