金大哥 - fmp_mcp_server MCP 详情

article

README

🚀 金融建模准备（FMP）MCP服务器

本服务器是一个模型上下文协议（MCP）服务器，它提供对Financial Modeling Prep (FMP) API数据的访问。通过标准化接口，该服务器能让AI助手（如Claude）以编程方式访问财务数据。

✨ 主要特性

公司概况：可获取公司信息、描述、市值、员工人数和行业数据。
财务报表：能够检索收入表、资产负债表和现金流量表。
财务指标：可获得关键指标、比率和增长数据。
分析师数据：能访问分析师估计和建议。
SEC文件：可查找并获取SEC文件内容。
收益转录：可以获取收益电话记录。
市场数据：能访问当前股票价格和国债收益率。
竞争对手分析：可找到竞争对手公司。

📦 安装指南

先决条件

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

设置

克隆此仓库。
在项目根目录中创建一个 .env 文件，其中包含您的 API 密钥：

# Financial Modeling Prep API配置
FMP_KEY=your_api_key_here

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

使用 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 服务器以访问财务数据。以下是设置方法：

下载 Claude Desktop。
编辑 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 个。

fmp_mcp_server