Financial Modeling Prep MCP Server

by shadi-fsai
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides access to Apple's financial data, including company profile, financial statements, metrics, and analyst estimates for investment analysis

  • Allows access to Meta's earnings transcripts, financial statements, company profile, and market performance metrics

  • Enables retrieval of Tesla's financial statements, company profile, and market performance data for financial analysis

財務モデリング準備(FMP)MCPサーバー

標準化されたインターフェースを介してFinancial Modeling Prep (FMP) APIデータへのアクセスを提供するModel Context Protocol (MCP)サーバー。このサーバーにより、ClaudeのようなAIアシスタントはプログラムから財務データにアクセスできるようになります。

特徴

  • 企業プロフィール: 企業情報、説明、時価総額、従業員数、業界データにアクセスします
  • 財務諸表:損益計算書、貸借対照表、キャッシュフロー計算書を取得します
  • 財務指標: 主要な指標、比率、成長データを取得します
  • アナリストデータ: アナリストの見積もりと推奨事項にアクセス
  • SEC提出書類: SEC提出書類の内容を検索して取得する
  • 決算説明会の記録: 決算説明会の記録を入手する
  • 市場データ:現在の株価と国債利回りにアクセス
  • 競合分析:競合企業を見つける

インストール

前提条件

  • Python 3.8以上
  • UV パッケージ マネージャー (推奨) または pip
  • 財務モデリング準備APIキー

設定

  1. このリポジトリをクローンする
  2. API キーを使用してプロジェクト ルートに.envファイルを作成します。
    # Financial Modeling Prep API Configuration FMP_KEY=your_api_key_here # Optional: SEC API Configuration SEC_ACCESS=YourCompanyName YourEmail@example.com
  3. UV を使用して依存関係をインストールします (推奨):
    uv venv uv pip install -r requirements.txt
    または pip を使用します:
    pip install -r requirements.txt

サーバーの実行

UVの使用(推奨)

UVは依存関係の解決とインストールを高速化します。UVでサーバーを実行するには、以下の手順を実行します。

# Activate the virtual environment uv venv activate # Run the server python fmp_mcp_server.py

サーバーが起動し、デフォルトの MCP ポートで接続をリッスンします。

pipの使用

# Create and activate a virtual environment python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Run the server python fmp_mcp_server.py

Claude Desktopとの接続

Claude DesktopはMCPサーバーに接続して財務データにアクセスできます。設定方法は次のとおりです。

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

これで、クロードはMCPインターフェースを介してFMPデータを使用できるようになりました。クロードに以下のことを依頼できます。

  • 企業プロフィールを取得する
  • 財務諸表を取得する
  • SEC提出書類を探す
  • 市場データにアクセスする
  • さらにもっと!

クロードのクエリ例

接続すると、次のような質問をクロードに尋ねることができます。

  • 「3年間の投資を検討していますが、Appleは良い投資でしょうか?」
  • 「テスラの最新の四半期損益計算書を見せてください」
  • 「マイクロソフトの最新の10-Kファイルを見つける」
  • 「Amazonの主な競合相手は何ですか?」
  • 「Metaの最新の収益トランスクリプトを入手」

設定オプション

サーバーは次の環境変数をサポートしています。

  • FMP_KEY : Financial Modeling Prep APIキー(必須)
  • SEC_ACCESS : SEC APIアクセス用の会社名とメールアドレス(オプション)

キャッシング

サーバーは、API 呼び出しを減らしてパフォーマンスを向上させるためにキャッシュ システムを実装します。

  • 財務データは四半期/年ごとにキャッシュされます
  • プロフィールデータは毎月キャッシュされます
  • 当日の価格データはキャッシュされます

キャッシュ ファイルはDataCacheディレクトリに保存されます。

ログ記録

ログはローテーションが有効になっているlogsディレクトリに書き込まれます。

  • 最大ログファイルサイズ: 10MB
  • バックアップファイル数: 5

ライセンス

MITライセンス

謝辞

-
security - not tested
A
license - permissive license
-
quality - not tested

Claude のような AI アシスタントが Financial Modeling Prep API から企業プロファイル、財務諸表、指標、SEC 提出書類、市場データなどの財務データにプログラムでアクセスできるようにするモデル コンテキスト プロトコル サーバー。

  1. Features
    1. Installation
      1. Prerequisites
      2. Setup
    2. Running the Server
      1. Using UV (Recommended)
      2. Using pip
    3. Connecting with Claude Desktop
      1. Example Queries for Claude
        1. Configuration Options
          1. Caching
            1. Logging
              1. License
                1. Acknowledgements
                  ID: z8hs1uvb5a