🚀 金融建模准备（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 个。