Finance MCP

🚀 金融建模准备MCP服务器

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

[](https://smithery.ai/server/@Alex2Yang97/financialmodelingprep-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	获取股息、收益、首次公开募股和拆分日历
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	以轻量或完整模式获取加密货币的历史收盘价
get_crypto_intraday	按1分钟、5分钟或1小时间隔获取加密货币的日内数据
get_crypto_news	搜索与加密货币相关的新闻
get_crypto_latest_news	获取最新的加密货币新闻

实际用例

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

股票分析

• 价格分析：“显示苹果公司过去6个月的每日历史股价。”
• 财务健康：“获取微软的季度资产负债表。”
• 绩效指标：“从股票信息中获取特斯拉的关键财务指标是什么？”
• 趋势分析：“比较亚马逊和谷歌的季度损益表。”
• 现金流分析：“显示英伟达的年度现金流量表。”

市场研究

• 新闻分析：“获取Meta Platforms的最新新闻文章。”
• 市场推动者：“列出今日涨幅和跌幅最大的股票。”
• 期权分析：“获取SPY在2024年6月21日到期的看涨期权链。”

投资研究

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

📦 安装指南

要求

• Python 3.11或更高版本
• pyproject.toml中列出的依赖项，包括：
  • mcp
  • requests
  • pandas
  • pydantic
  • 以及其他用于数据处理的包

设置步骤

1. 克隆此仓库：

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

2. 创建并激活虚拟环境，然后安装依赖项：

   uv venv
   source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate
   uv pip install -e .
   

3. 设置你的金融建模准备API密钥：

   export FMP_API_KEY=YOUR_API_KEY
   

💻 使用示例

开发模式

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

uv run server.py

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

与Claude桌面版集成

要将此服务器与Claude桌面版集成，请执行以下操作：

1. 在本地机器上安装Claude桌面版。
2. 在本地机器上安装VS Code。然后运行以下命令打开claude_desktop_config.json文件：
   • macOS：code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • Windows：code $env:AppData\Claude\claude_desktop_config.json
3. 编辑Claude桌面版配置文件，位置如下：
   • macOS：

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

   • Windows：

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

   • 注意：你可能需要在命令字段中输入uv可执行文件的完整路径。你可以在macOS/Linux上运行which uv或在Windows上运行where uv来获取此路径。
4. 重启Claude桌面版

📄 许可证

MIT