Fmp MCP Server

🚀 金融モデリング準備（FMP）MCPサーバー

このサーバーは、Financial Modeling Prep (FMP) APIのデータにアクセスできるモデルコンテキストプロトコル（MCP）サーバーです。標準化されたインターフェースを通じて、AIアシスタント（Claudeなど）に財務データへのプログラミングアクセスを提供します。

✨ 主な機能

• 企業概要：企業情報、説明、時価総額、従業員数、業界データを取得します。
• 財務諸表：損益計算書、貸借対照表、キャッシュフロー計算書を検索します。
• 財務指標：主要指標、比率、成長データを取得します。
• アナリストデータ：アナリストの予測とアドバイスにアクセスします。
• SECファイル：SECファイルを検索し、内容を取得します。
• 収益通話記録：収益通話の記録を取得します。
• 市場データ：現在の株価と国債利回りにアクセスします。
• 競合分析：競合企業を特定します。

📦 インストール

前提条件

• Python 3.8以上
• UVパッケージマネージャー（推奨）またはpip
• Financial Modeling Prep APIキー

セットアップ

1. このリポジトリをクローンします。
2. プロジェクトのルートディレクトリに.envファイルを作成し、APIキーを記載します。

   # Financial Modeling Prep API設定
   FMP_KEY=your_api_key_here
   
   # オプション：SEC API設定
   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を使用してサーバーを起動します。

# 仮想環境をアクティブ化
uv venv activate

# サーバーを起動
python fmp_mcp_server.py

サーバーが起動し、デフォルトのMCPポートで接続を待機します。

pipを使用する場合

# 仮想環境を作成してアクティブ化
python -m venv venv
source venv/bin/activate  # Windowsの場合は：venv\Scripts\activate

# サーバーを起動
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"
        ]
    }
}

これで、ClaudeはMCPインターフェースを通じてFMPデータを使用できます。Claudeに以下の操作を要求できます。

• 企業概要を取得する
• 財務諸表を検索する
• マイクロソフトの最新の10 - Kファイルを検索する
• アマゾンの主要な競合企業を取得する
• Metaの最新の収益通話記録を取得する

設定オプション

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

• FMP_KEY：あなたのFinancial Modeling Prep APIキー（必須）
• SEC_ACCESS：SEC APIにアクセスするための会社名とメールアドレス（オプション）

キャッシュ

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

• 財務データは四半期/年単位でキャッシュされます。
• プロファイルデータは月単位でキャッシュされます。
• 日次の価格データは当日でキャッシュされます。 キャッシュファイルはDataCacheディレクトリに保存されます。

ログ記録

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

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