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