Finance MCP

🚀 金融建模準備MCP服務器

這是一個模型上下文協議（MCP）服務器，可從金融建模準備（Financial Modeling Prep）提供全面的金融數據。它允許你檢索股票的詳細信息，包括歷史價格、公司信息、財務報表、期權數據和市場新聞。

🚀 快速開始

演示

MCP工具

該服務器通過模型上下文協議公開了以下工具：

股票信息

財務報表

期權數據

股票評級

參考數據

公司事件

加密貨幣數據

實際用例

使用此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