Finance MCP

🚀 ファイナンシャルモデリングプレップMCPサーバー

このサーバーは、Model Context Protocol (MCP) を使用して、Financial Modeling Prepから包括的な金融データを提供します。株式の詳細情報（過去の価格、会社情報、財務諸表、オプションデータ、市場ニュースなど）を取得できます。

🚀 クイックスタート

📺 デモ

✨ 主な機能

このサーバーは、Model Context Protocolを通じて以下のツールを提供します。

株式情報

財務諸表

オプションデータ

株式評価

参照データ

企業イベント

暗号通貨データ

💻 実際の使用例

このMCPサーバーを使用すると、Claudeを使って以下のようなことができます。

株式分析

• 価格分析：「過去6か月間のAAPLの日次の過去の株価を表示してください。」
• 財務健全性分析：「Microsoftの四半期の貸借対照表を取得してください。」
• パフォーマンス指標分析：「株式情報からTeslaの主要な財務指標は何ですか？」
• トレンド分析：「AmazonとGoogleの四半期の損益計算書を比較してください。」
• キャッシュフロー分析：「NVIDIAの年次のキャッシュフロー計算書を表示してください。」

市場調査

• ニュース分析：「Meta Platformsに関する最新のニュース記事を取得してください。」
• 市場動向分析：「今日の上位の上昇株と下落株をリストアップしてください。」
• オプション分析：「満期日が2024-06-21のSPYのコールオプションチェーンを取得してください。」

投資調査

• 「Microsoftの最新の四半期の財務諸表を使用して、財務健全性の包括的な分析を作成してください。」
• 「Coca-ColaとPepsiCoの配当履歴と株式分割を比較してください。」
• 「30日で満期となるApple株のオプション市場の活動に関するレポートを作成してください。」

📦 インストール

必要条件

• 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. Financial Modeling PrepのAPIキーを設定します：

   export FMP_API_KEY=YOUR_API_KEY
   

💻 使用例

開発モード

以下のコマンドを実行して、MCP Inspectorでサーバーをテストできます。

uv run server.py

これによりサーバーが起動し、利用可能なツールをテストできます。

Claude for Desktopとの統合

このサーバーをClaude for Desktopと統合するには、次の手順を実行します。

1. ローカルマシンにClaude for Desktopをインストールします。

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 for Desktopの設定ファイルを編集します。

   • 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 for Desktopを再起動します。

📄 ライセンス

MIT