使用说明

财务建模准备MCP服务器

English | 中文

这是一个模型上下文协议（MCP）服务器，提供来自财务建模准备的全面财务数据。它允许您检索有关股票的详细信息，包括历史价格、公司信息、财务报表、期权数据和市场新闻。

演示

MCP工具

服务器通过模型上下文协议公开以下工具：

股票信息

工具	说明
`get_historical_stock_prices`	获取具有可定制周期和间隔的股票的历史OHLCV数据
`get_stock_info`	获取全面的股票数据，包括价格、指标和公司详细信息
`get_news_sentiment`	获取股票的最新新闻文章
`get_stock_actions`	获取股票股息和拆分历史记录

财务报表

工具	说明
`get_financial_statement`	使用财务建模准备工具获取损益表、资产负债表或现金流量表（年度/季度）

选项数据

工具	说明
`get_option_expiration_dates`	获取可用选项的到期日期
`get_option_chain`	获取特定到期日期和类型（看涨/看跌）的期权链

库存等级

工具	说明
`get_stock_grades`	获取股票的最新分析师评级
`get_stock_grades_historical`	获取历史分析师评分
`get_stock_grades_summary`	获得分析师评分的共识摘要
`get_stock_grade_news`	获取股票的等级相关新闻
`get_stock_grade_latest_news`	获取最新的分析师级新闻
`get_analyst_estimates`	检索分析师的财务估计
`get_ratings`	获取评级快照或历史记录
`get_price_target_info`	获取价格目标摘要、共识或新闻

参考数据

工具	说明
`lookup_identifier`	按符号、名称、CIK、CUSIP或ISIN搜索
`get_directory_list`	检索交易所、行业和其他列表

企业活动

工具	说明
`get_calendar_data`	获取股息、收益、IPO和拆分日历
`get_shares_float_info`	检索一家或所有公司的浮动数据
`get_ma_data`	获取最新或搜索并购交易
`get_executive_info`	获取公司高管或薪酬信息
`get_dcf_valuation`	获得DCF或杠杆DCF估值
`get_economic_data`	检索国债利率和其他宏观数据

加密货币数据

工具	说明
`get_crypto_list`	检索可交易加密货币列表
`get_crypto_quote`	获取加密货币的完整报价数据
`get_crypto_quote_short`	获取加密货币的快速报价数据
`get_all_crypto_quotes`	获取所有加密货币的实时报价
`get_crypto_price_eod`	在轻模式或全模式下获取历史加密货币EOD价格
`get_crypto_intraday`	以1分钟、5分钟或1小时的间隔获取日内加密货币数据
`get_crypto_news`	搜索加密货币相关新闻
`get_crypto_latest_news`	检索最新的加密货币新闻

真实世界用例

使用此MCP服务器，您可以使用Claude执行以下操作：

股票分析

价格分析：“给我看看过去6个月AAPL的历史股价，每天都有。”
财务健康状况：“获取微软的季度资产负债表。”
性能指标：“从股票信息来看，特斯拉的关键财务指标是什么？”
趋势分析：“比较亚马逊和谷歌的季度损益表。”
现金流量分析：“给我看看NVIDIA的年度现金流量表。”

市场调研

新闻分析：“获取有关元平台的最新新闻文章。”
市场推手：“列出今天最大的赢家和输家。”
期权分析：“获取到期日为2024-06-21的SPY期权链。”

投资研究

“使用微软最新的季度财务报表，对微软的财务状况进行全面分析。”
“比较可口可乐和百事可乐的股息历史和股票分割。”
“生成一份关于30天后到期的苹果股票期权市场活动的报告。”

需求

Python 3.11或更高版本
依赖关系如所列 pyproject.toml，包括：
- 主控程序
- 请求：
- 熊猫
- 媒染剂
- 以及用于数据处理的其他软件包

设置

克隆此存储库：

git clone https://github.com/Alex2Yang97/financialmodelingprep-mcp.git
cd financialmodelingprep-mcp

创建和激活虚拟环境并安装依赖项：

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .

设置财务建模准备API键：
```
export FMP_API_KEY=YOUR_API_KEY
```

用法

发展模式

您可以通过运行以下命令使用MCP Inspector测试服务器：

uv run server.py

这将启动服务器，并允许您测试可用的工具。

与Claude for Desktop集成

要将此服务器与Claude for Desktop集成，请执行以下操作：

将Claude for Desktop安装到本地计算机。
将VS Code安装到本地计算机。然后运行以下命令打开 claude_desktop_config.json 文件：
- MacOS： code ~/Library/Application\ Support/Claude/claude_desktop_config.json
- 窗户： code $env:AppData\Claude\claude_desktop_config.json

编辑Claude for Desktop配置文件，位于：

macOS：

{
  "mcpServers": {
    "financialmodelingprep": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/financialmodelingprep-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

窗户：

{
  "mcpServers": {
    "financialmodelingprep": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\financialmodelingprep-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

备注：您可能需要在命令字段中输入uv可执行文件的完整路径。你可以通过跑步来获得这个 which uv 在MacOS/Linux或 where uv 在Windows上。

重新启动桌面版的Claude

许可证

麻省理工学院