Financial Modeling Prep MCP Server

🚀 Financial Modeling Prep MCP (Model Context Protocol) Server

このFinancial Modeling PrepのModel Context Protocol (MCP) 実装は、AIアシスタントが金融データ、株式情報、企業の基礎データ、および市場インサイトにアクセスし、分析することを可能にします。

🚀 クイックスタート

このMCPサーバーは、AIアシスタントが金融データにアクセスするための強力なツールを提供します。次のセクションでは、サーバーのアーキテクチャ、設定方法、使用例などを詳しく説明します。

✨ 主な機能

• 網羅的なカバレッジ：24カテゴリーにわたる253以上の金融ツールにアクセス可能です。
• ツールセットのフィルタリング：必要なツールのみを読み込むことで、複雑さを軽減し、パフォーマンスを向上させます。
• リアルタイムデータ：リアルタイムの株価、市場データ、および金融情報を提供します。
• 財務諸表：損益計算書、貸借対照表、キャッシュフロー計算書、および財務比率を提供します。
• 市場分析：テクニカル指標、アナリストの予測、および市場パフォーマンス指標を提供します。
• 経済データ：財務省の金利、GDP、インフレ、経済指標などの経済データを提供します。
• 代替データ：ESGスコア、インサイダー取引、議会の取引、および社会的センチメントなどの代替データを提供します。

📦 インストール

本番環境でのSmitheryレジストリを使用したインストール

本番環境では、Smitheryレジストリを通じてこのMCPサーバーを使用できます。 🚀 Smitheryで表示

HTTPサーバーとローカル開発

# クローンとセットアップ
git clone https://github.com/imbenrabi/Financial-Modeling-Prep-MCP-Server
cd Financial-Modeling-Prep-MCP-Server
npm install
npm run build

# 開発モードで実行
FMP_ACCESS_TOKEN=YOUR_TOKEN npm run dev

# またはCLI引数を使用
npm run dev -- --fmp-token=YOUR_TOKEN
npm run dev -- --port=4000 --fmp-token=YOUR_TOKEN

Dockerを使用したインストール

# 基本的なデプロイ
docker run -p 8080:8080 -e FMP_ACCESS_TOKEN=YOUR_TOKEN your-image-name

# サーバーレベルのダイナミックモードで実行
docker run -p 8080:8080 \
  -e FMP_ACCESS_TOKEN=YOUR_TOKEN \
  -e DYNAMIC_TOOL_DISCOVERY=true \
  your-image-name

# サーバーレベルのスタティックモードで実行
docker run -p 8080:8080 \
  -e FMP_ACCESS_TOKEN=YOUR_TOKEN \
  -e FMP_TOOL_SETS=search,company,quotes \
  your-image-name

💻 使用例

基本的な使用法

# ダイナミックモードのセッションを初期化
CONFIG_BASE64=$(echo -n '{"DYNAMIC_TOOL_DISCOVERY":"true"}' | base64)
curl -X POST "http://localhost:8080/mcp?config=${CONFIG_BASE64}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "clientInfo": {
        "name": "my-client",
        "version": "1.0.0"
      },
      "capabilities": {}
    }
  }'

高度な使用法

# ツールセットを有効にする（ダイナミックモード）
CONFIG_BASE64=$(echo -n '{"DYNAMIC_TOOL_DISCOVERY":"true"}' | base64)
curl -X POST "http://localhost:8080/mcp?config=${CONFIG_BASE64}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "enable_toolset",
      "arguments": {
        "toolset": "search"
      }
    }
  }'

📚 ドキュメント

サーバーアーキテクチャ

このMCPサーバーは、Smithery SDKを使用したステートフルなセッションベースのアーキテクチャを採用しています。

設定とモードの適用

サーバーは複数の設定方法をサポートし、明確な優先順位階層に従って動作します。

選択的なツールの読み込み

必要なツールカテゴリのみを指定して読み込むことで、パフォーマンスを最適化できます。

動的ツールセット管理 (BETA)

この機能を使用すると、実行時にツールカテゴリを有効または無効にすることができます。

HTTPリクエストの送信

サーバーは /mcp エンドポイントでJSON-RPC形式のリクエストを受け付けます。

利用可能なツール

このMCPは、AIアシスタントが金融データにアクセスするための様々なツールを提供します。

Financial Modeling Prepアクセストークンの取得方法

Financial Modeling Prepのアクセストークンを取得するには、Financial Modeling Prepのウェブサイトにアクセスしてください。

コントリビュート方法

コントリビューションは大歓迎です。詳細な手順は「コントリビュート」セクションを参照してください。

問題とバグレポート

バグや機能リクエスト、プロジェクトに関する質問がある場合は、GitHubでIssueを開いてください。

ライセンス

このプロジェクトは Apache License Version 2.0 の下でライセンスされています。

🔧 技術詳細

サーバーアーキテクチャの詳細

• クライアントレベルのキャッシュ：各 clientId に対して1つの McpServer/DynamicToolsetManager が維持されます。
• セッションの分離：セッションはSDKによって管理され、キャッシュには sessionId は使用されません。
• ステートフル管理：セッションは複数のリクエストにわたって状態を維持します。
• モードの適用：サーバーレベルの設定はセッションレベルの設定を上書きすることができます。
• HTTPベースのプロトコル：JSON-RPC形式のメッセージを使用してHTTPで通信します。
• 動的ツール管理：各セッションで実行時にツールを読み込んだり、アンロードしたりすることができます。

リクエストフロー

1. クライアントリクエスト → /mcp エンドポイントへのHTTP POST
2. セッション管理 → サーバーが設定に基づいてセッションを作成または取得
3. モード解決 → サーバーが動作モード（ダイナミック/スタティック/レガシー）を決定
4. ツール登録 → 解決されたモードに基づいてセッション固有のツールが読み込まれる
5. リクエスト処理 → 利用可能なツールを使用してMCPリクエストが処理される
6. レスポンス → JSON-RPCレスポンスがクライアントに返される

📄 ライセンス

このプロジェクトは Apache License Version 2.0 の下でライセンスされています。