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 許可證。

項目狀態