Financial Modeling Prep (FMP) MCP 服务器

一个模型上下文协议 (MCP) 服务器，通过标准化的接口提供对 Financial Modeling Prep (FMP) API 数据的访问。此服务器允许像 Claude 这样的 AI 助手以编程方式访问财务数据。

功能

• 公司概况: 访问公司信息、描述、市值、员工人数和行业数据
• 财务报表: 获取利润表、资产负债表和现金流量表
• 财务指标: 获取关键指标、比率和增长数据
• 分析师数据: 访问分析师的估计和建议
• 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：

• 获取公司概况
• 检索财务报表
• 查找 SEC 文件
• 访问市场数据
• 还有更多！

Claude 的示例查询

连接后，您可以向 Claude 提出如下问题：

• "我正在考虑一个 3 年期限的投资，苹果公司是一个好的投资吗？"
• "显示特斯拉最新的季度利润表"
• "查找微软最新的 10-K 文件"
• "亚马逊的主要竞争对手有哪些？"
• "获取 Meta 最新的盈利电话会议记录"

配置选项

服务器支持以下环境变量：

• FMP_KEY: 您的 Financial Modeling Prep API 密钥（必需）
• SEC_ACCESS: 您的公司名称和电子邮件，用于 SEC API 访问（可选）

缓存

服务器实现了一个缓存系统，以减少 API 调用并提高性能：

• 财务数据按季度/年份缓存
• 概况数据每月缓存
• 每日价格数据缓存为当天

缓存文件存储在 DataCache 目录中。

日志记录

日志写入到启用了轮换的 logs 目录：

• 最大日志文件大小：10MB
• 备份文件数：5

许可证

MIT 许可证

致谢

• Financial Modeling Prep 提供 API
• MCP Server 提供模型上下文协议实现