Financial Modeling Prep (FMP) MCP Server

Financial Modeling Prep (FMP) MCP Server

site icon
2025.04.12 7
Python金融数据服务财务分析工具金融服务
Financial Modeling Prep (FMP) MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,通过标准化接口提供对 Financial Modeling Prep (FMP) API 数据的访问。该服务允许 AI 助手(如 Claude)以编程方式访问金融数据。
View on GitHub

Overview

基本能力

产品定位

FMP MCP Server 是一个金融数据服务,提供公司信息、财务报表、市场数据等金融相关数据的标准化访问接口。

核心功能

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

适用场景

  • 投资分析
  • 财务研究
  • 市场趋势分析
  • 公司比较
  • 财务报告生成

工具列表

  • Financial Modeling Prep API:提供金融数据的核心 API
  • MCP Server:实现 Model Context Protocol 的服务器

常见问题解答

  • 如何获取 API 密钥?:需要从 Financial Modeling Prep 网站注册并获取
  • 数据缓存如何工作?:财务数据按季度/年缓存,配置文件数据按月缓存,每日价格数据当天缓存
  • 日志存储在哪里?:日志存储在 logs 目录中,最大文件大小为 10MB,备份文件数为 5

使用教程

使用依赖

  • Python 3.8 或更高版本
  • UV 包管理器(推荐)或 pip
  • Financial Modeling Prep API 密钥

安装教程

  1. 克隆仓库

  2. 在项目根目录创建 .env 文件,包含 API 密钥: ``` # Financial Modeling Prep API Configuration FMP_KEY=your_api_key_here

# Optional: SEC API Configuration SEC_ACCESS=YourCompanyName [email protected] ```

  1. 使用 UV(推荐)安装依赖: bash uv venv uv pip install -r requirements.txt

或使用 pip: bash pip install -r requirements.txt

调试方式

使用 UV(推荐)

# 激活虚拟环境
uv venv activate

# 运行服务器
python fmp_mcp_server.py

使用 pip

# 创建并激活虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 运行服务器
python fmp_mcp_server.py

连接 Claude Desktop

  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" ]

示例查询

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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。