Finance Tools

🚀 金融ツール MCP サーバー：finance-tools-mcp

finance-tools-mcp は、モデルコンテキストプロトコル（MCP）に基づくサーバーです。大規模言語モデル（LLMs）に対して包括的な財務分析機能を提供することを目的としています。このサーバーは investor-agent を改変して作成され、複数のデータソースと分析ライブラリを統合し、詳細な金融研究をサポートするツールキットを提供します。

https://github.com/VoxLink-org/finance-tools-mcp

🚀 クイックスタート

finance-tools-mcp は、モデルコンテキストプロトコル（MCP）に基づくサーバーで、大規模言語モデル（LLMs）に幅広い財務分析機能を提供します。このサーバーは複数のデータソースと分析ライブラリを統合し、金融研究をサポートするツールキットを提供します。

✨ 主な機能

1. 財務分析ツール

• リアルタイム株価データ取得：複数のソースからリアルタイムの株価、取引量などの情報を取得します。
• テクニカル指標計算：移動平均線（MA）、相対力指数（RSI）、MACD などの指標を計算します。
• 財務報表解析：会社の財務報告を解析し、収益、利益、負債比率などの重要な財務指標を抽出します。

2. 金融データ処理

• データクリーニングと前処理：取得した金融データのノイズ除去と形式の統一を行います。
• 時系列分析：ARIMA、LSTM などのモデルを使用して予測を行います。
• リスク管理ツール：リスク価値（VaR）、信用スコアなどのツールを提供します。

3. 可視化とレポート

• インタラクティブなグラフ生成：ローソク足チャート、折れ線グラフ、棒グラフなど、さまざまなタイプの金融データの可視化をサポートします。
• 自動レポート生成：分析結果に基づいて自動的に財務レポートと投資アドバイスを生成します。

🔧 技術詳細

時系列データの処理と分析

このサーバーは、時系列データの処理と分析について高度に最適化されています。

• 効率的なデータストレージ：大規模な時系列データを効率的なデータベース技術で保存します。
• リアルタイムデータ分析：リアルタイムのデータフロー処理をサポートし、ミリ秒単位の応答を提供します。
• 予測モデルの統合：Facebook Prophet、TensorFlow などの複数の予測モデルを統合しています。

📦 インストール

1. インストール手順

# uvx のインストール
sh <https://install.llmops.com/v0.6.0/install.sh>

# finance-tools-mcp サーバーの起動
uvx finance-tools-mcp

2. 環境変数の設定

米連邦準備制度理事会の経済データサービス（FRED）の API キーがある場合は、以下のように設定できます。

FRED_API_KEY=YOUR_API_KEY uvx finance-tools-mcp

3. 起動オプション

• Server-Sent Events (SSE) 伝送プロトコルを使用して起動する場合：

uvx finance-tools-mcp --transport sse

• FRED API キーと SSE 伝送を組み合わせる場合：

FRED_API_KEY=YOUR_API_KEY uvx finance-tools-mcp --transport sse

💻 使用例

MCP クライアントへの統合

finance-tools-mcp を MCP クライアント（Claude Desktop など）に統合するには、設定ファイルに以下の内容を追加します。

{
  "mcpServers": {
    "investor": {
        "command": "path/to/uvx/command/uvx",
        "args": ["finance-tools-mcp"],
    }
  }
}

デバッグ

MCP チェックツールを使用してデバッグを行います。

npx @modelcontextprotocol/inspector uvx finance-tools-mcp

または

npx @modelcontextprotocol/inspector uv --directory  ./ run finance-tools-mcp

ログ監視パス

• macOS: ~/Library/Logs/Claude/mcp*.log
• Windows: %APPDATA%\Claude\logs\mcp*.log

開発とテスト

1. MCP チェックツールを使用してデバッグを行います。
2. Claude Desktop で以下の設定を使用してテストを行います。

{
  "mcpServers": {
    "investor": {
      "command": "path/to/uv/command/uv",
      "args": ["--directory", "path/to/finance-tools-mcp", "run", "finance-tools-mcp"],
    }
  }
}

📄 ライセンス

この MCP サーバーは MIT ライセンスの下で提供されています。詳細は LICENSE ファイルを参照してください。

🔍 サンプルレポート

• carvana_analysis.md
• palantir_analysis.md
• pdd_analysis_20250503.md
• meli_se_shop_comparison_20250504.md
• GLD_analysis_20250508.md

📋 今後の予定

• [ ] サポートレベルとレジスタンスレベルの分析機能を追加する
• [x] フィボナッチリトレースメント分析を追加済み
• [ ] 移動平均収束拡散（MACD）予測モデルを追加する
• [ ] オプション価格モデルを開発して予測を行う
• [ ] 財務報告とその他の特徴に基づいて予測モデルを構築する