Fmp MCP Server

🚀 金融建模準備（FMP）MCP服務器

本服務器是一個模型上下文協議（MCP）服務器，它提供對Financial Modeling Prep (FMP) API數據的訪問。通過標準化接口，該服務器能讓AI助手（如Claude）以編程方式訪問財務數據。

✨ 主要特性

• 公司概況：可獲取公司信息、描述、市值、員工人數和行業數據。
• 財務報表：能夠檢索收入表、資產負債表和現金流量表。
• 財務指標：可獲得關鍵指標、比率和增長數據。
• 分析師數據：能訪問分析師估計和建議。
• SEC文件：可查找並獲取SEC文件內容。
• 收益轉錄：可以獲取收益電話記錄。
• 市場數據：能訪問當前股票價格和國債收益率。
• 競爭對手分析：可找到競爭對手公司。

📦 安裝指南

先決條件

• Python 3.8 或更高版本。
• UV 包管理器（推薦）或 pip。
• Financial Modeling Prep API 密鑰。

設置

1. 克隆此倉庫。
2. 在項目根目錄中創建一個 .env 文件，其中包含您的 API 密鑰：

# Financial Modeling Prep API配置
FMP_KEY=your_api_key_here

# 可選：SEC API配置
SEC_ACCESS=YourCompanyName YourEmail@example.com

3. 使用 UV 安裝依賴項（推薦）：

uv venv
uv pip install -r requirements.txt

或使用 pip：

pip install -r requirements.txt

💻 使用示例

運行服務器

使用 UV（推薦）

UV 提供更快的依賴項解析和安裝。使用 UV 運行服務器：

# 激活虛擬環境
uv venv activate

# 運行服務器
python fmp_mcp_server.py

服務器將啟動並偵聽默認 MCP 端口上的連接。

使用 pip

# 創建並激活一個虛擬環境
python -m venv venv
source venv/bin/activate  # 在Windows上：venv\Scripts\activate

# 運行服務器
python fmp_mcp_server.py

與 Claude Desktop 連接

Claude Desktop 可以連接到 MCP 服務器以訪問財務數據。以下是設置方法：

1. 下載 Claude Desktop。
2. 編輯 claude_desktop_config.json：

"fmp_mcp_server": {
    "command": "uv",
    "args": [
        "--directory",
        "REPLACE ME WITH ABSOLUTE DIRECTORY TO REPO",
        "run",
        "fmp_mcp_server.py"
    ]
}

現在，Claude 可以通過 MCP 接口使用 FMP 數據。您可以要求 Claude 執行以下操作：

• 獲取公司概況。
• 檢索財務報表。
• 查找微軟的最新 10 - K 文件。
• 獲取亞馬遜的主要競爭對手。
• 獲取 Meta 的最新收益轉錄。

🔧 技術細節

配置選項

服務器支持以下環境變量：

• FMP_KEY：您的 Financial Modeling Prep API 密鑰（必需）。
• SEC_ACCESS：用於訪問 SEC API 的公司名稱和電子郵件地址（可選）。

緩存

服務器實現了一個緩存系統以減少 API 調用並提高性能：

• 財務數據按季度/年份緩存。
• 個人資料數據每月緩存一次。
• 每日價格數據當天緩存。 緩存文件存儲在 DataCache 目錄中。

日誌記錄

日誌寫入 logs 目錄，啟用輪轉：

• 最大日誌文件大小：10MB。
• 備份文件數量：5 個。