财务建模准备 (FMP) MCP 服务器

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

特征

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

安装

先决条件

• Python 3.8 或更高版本
• UV 包管理器（推荐）或 pip
• 财务建模准备 API 密钥

设置

1. 克隆此存储库
2. 使用您的 API 密钥在项目根目录中创建一个.env文件：
   # Financial Modeling Prep API Configuration FMP_KEY=your_api_key_here # Optional: SEC API Configuration SEC_ACCESS=YourCompanyName YourEmail@example.com
3. 使用 UV 安装依赖项（推荐）：
   uv venv uv pip install -r requirements.txt
   或者使用 pip：
   pip install -r requirements.txt

运行服务器

使用紫外线（推荐）

UV 提供更快的依赖项解析和安装速度。要使用 UV 运行服务器：

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

使用 pip

与 Claude Desktop 连接

Claude Desktop 可以连接到 MCP 服务器访问财务数据。设置方法如下：

1. 下载Claude桌面
2. 编辑 claude_desktop_config.json：“fmp_mcp_server”：{“command”：“uv”，“args”：[“--directory”，“用绝对目录替换我到 REPO”，“run”，“fmp_mcp_server.py”] }

现在，Claude 可以通过 MCP 接口使用 FMP 数据。您可以要求 Claude 执行以下操作：

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

Claude 的示例查询

连接后，您可以向 Claude 询问以下问题：

• “我正在考虑进行为期 3 年的投资，苹果是一项好的投资吗？”
• “给我看看特斯拉最新的季度损益表”
• “查找微软最新的 10-K 文件”
• “亚马逊的主要竞争对手有哪些？”
• “获取 Meta 的最新收益记录”

配置选项

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

• FMP_KEY ：您的财务建模准备 API 密钥（必需）
• SEC_ACCESS ：您的公司名称和用于 SEC API 访问的电子邮件（可选）

缓存

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

• 财务数据按季度/年度缓存
• 个人资料数据每月缓存一次
• 缓存当天的每日价格数据

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

日志记录

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

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

执照

MIT 许可证

致谢

• 提供 API 的财务建模准备
• 用于模型上下文协议实现的MCP 服务器