Financial Modeling Prep (FMP) MCP 服务器

这是一个 Model Context Protocol (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 运行服务器：

# Activate the virtual environment
uv venv activate

# Run the server
python fmp_mcp_server.py

服务器将启动并在默认的 MCP 端口上监听连接。

使用 pip

# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Run the server
python fmp_mcp_server.py

与 Claude 桌面版连接

Claude 桌面版可以连接到 MCP 服务器以访问财务数据。以下是设置方法：

1. 下载 Claude 桌面版
2. 编辑 claude_desktop_config.json：
   "fmp_mcp_server": {
   "command": "uv",
   "args": [
   "--directory",
   "请用存储库的绝对路径替换我",
   "run",
   "fmp_mcp_server.py"
   ]
   }

现在 Claude 可以通过 MCP 接口使用 FMP 数据了。您可以要求 Claude：

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

Claude 示例查询

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

• “我正在考虑为期三年的投资，苹果是否是一个好的投资选择？”
• “显示特斯拉最新的季度损益表”
• “查找微软最新的 10-K 文件”
• “亚马逊的主要竞争对手是谁？”
• “获取 Meta 最新的收益电话会议记录”

配置选项

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

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

缓存

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

• 财务数据按季度/年份进行缓存
• 档案数据每月缓存一次
• 当日的日价格数据会被缓存

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

日志记录

日志被写入到logs目录，并启用了日志轮转：

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

许可证

MIT License

致谢

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