📈 Finance MCP Server

📈 Finance MCP Server

Claude Desktop やその他の MCP 対応クライアントに、包括的な株式市場データとテクニカル分析機能を提供する強力な Model Context Protocol（MCP）サーバーです。

🚀 特長

• 📊 株式情報：企業プロフィール、市場指標、主要統計情報を網羅
• 📈 過去データ：複数の期間に対応した、カスタマイズ可能な過去の価格データ
• ⚡ リアルタイム相場：変動額の計算に対応した、リアルタイムの株価
• 🔧 テクニカル指標：プロ品質のテクニカル分析ツールを10種類以上提供
• 🚀 高パフォーマンス：最適な速度を実現するインテリジェントなキャッシュシステム
• 🛡️ 堅牢性：包括的なエラー処理と検証
• 🔌 簡単な連携：Claude Desktop にワンコマンドでインストール

📦 クイックインストール

Claude Desktop ユーザー向け

pip install finance-mcp-server

次に、Claude Desktop の設定に追加します。

{
  "mcpServers": {
    "finance": {
      "command": "finance-mcp-server"
    }
  }
}

Claude Desktop を再起動して、株式について質問しましょう！🎉

手動インストール

# Clone the repository
git clone https://github.com/akshatbindal/finance-mcp-server.git
cd finance-mcp-server

# Install in development mode
pip install -e .

# Or install from PyPI
pip install finance-mcp-server

🎯 使用例

インストール後、次のような自然言語の質問を Claude Desktop にすることができます。

• 「Apple の現在の株価と時価総額を教えてください」
• 「過去6か月間の Tesla の推移を見せてください」
• 「Microsoft 株の RSI と MACD を計算してください」
• 「Google と Amazon の50日移動平均を比較してください」
• 「Netflix の現在のボリンジャーバンドを教えてください」

🛠️ 利用可能なツール

Finance MCP Server は、MCP プロトコルを介して次のツールを公開します。

• get_comprehensive_stock_info：任意の株式シンボルについて、企業、市場、財務、アナリストの詳細データを取得します。
• get_historical_data：株式分割・配当を含む、期間と間隔をカスタマイズ可能な過去の価格データを取得します。
• get_options_data：複数の満期日を対象に、コールとプットを含む株式のオプションチェーンデータを取得します。
• get_institutional_holders：株式の機関投資家および主要株主を確認します。
• get_earnings_calendar：決算カレンダー、過去の実績、アナリストの目標株価を確認します。
• get_analyst_recommendations：アナリストの推奨、格上げ、格下げを取得します。
• get_financial_statements：損益計算書、貸借対照表、キャッシュフロー計算書の全データをダウンロードします（年次／四半期）。
• get_news：株式に関する最新ニュースの見出しとメタデータを取得します。
• get_technical_analysis：プロ向け指標（SMA、EMA、RSI、MACD、ボリンジャーバンド、出来高、サポート／レジスタンスなど）を取得します。
• get_sector_performance：複数の株式のパフォーマンス、ボラティリティ、指標を比較します。
• get_dividend_history：配当の支払い履歴、概要、統計情報を取得します。

ツール呼び出し例（MCP JSON）

{
  "tool": "get_comprehensive_stock_info",
  "arguments": {"symbol": "AAPL"}
}

キャッシュとパフォーマンス

• 企業情報、ニュース、オプション、株主、カレンダー、推奨：5～60分のキャッシュ
• リアルタイムデータ：1分のキャッシュ
• ファンダメンタルズ：10分のキャッシュ
• 最適化された yfinance の利用：マルチスレッドを有効化し、バッチリクエストとエラー分離に対応

エラー処理

• すべてのエンドポイントは、失敗時に明確なエラーメッセージを返します
• データが欠落または一部のみの場合は、適切にフォールバックします
• すべての例外と警告をログに記録します

テクニカル分析

• 移動平均（SMA 20/50/200、EMA 12/26）
• RSI、MACD、ボリンジャーバンド、出来高の推移
• サポート／レジスタンス、ボラティリティなど

拡張データ

• オプションチェーン（コール／プット、OI、IV、最終取引）
• 機関投資家／主要株主
• 決算カレンダー／履歴、アナリスト目標株価
• 財務諸表の全データ（年次／四半期）
• ニュースの見出し、配信元、関連銘柄
• 配当の履歴と概要

🛠️ 設定

基本設定

{
  "mcpServers": {
    "finance": {
      "command": "finance-mcp-server"
    }
  }
}

詳細設定

{
  "mcpServers": {
    "finance": {
      "command": "finance-mcp-server",
      "env": {
        "LOG_LEVEL": "INFO",
        "CACHE_DURATION": "300"
      }
    }
  }
}

🔧 開発

開発環境のセットアップ

# Clone the repository
git clone https://github.com/akshatbindal/finance-mcp-server.git
cd finance-mcp-server

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install in development mode
pip install -e .

# Install development dependencies
pip install pytest black flake8 mypy

# Run tests
pytest

# Format code
black finance_mcp/

# Type checking
mypy finance_mcp/

サーバーの実行

# Run directly
python -m finance_mcp.server

# Or use the console script
finance-mcp-server

# With debug logging
LOG_LEVEL=DEBUG finance-mcp-server

📊 パフォーマンス機能

インテリジェントなキャッシュ

• 株価情報とテクニカル指標：5分間キャッシュ
• リアルタイムデータ：1分間キャッシュ
• 過去のデータ：セッションベースのキャッシュ
• キャッシュの自動無効化

エラー処理

• 無効な株式シンボルを適切に処理
• ネットワークタイムアウトを防止
• 詳細なエラーメッセージ
• データ取得のフォールバック機構

🔒 プライバシーとセキュリティ

• データを保存しません：すべてのデータは Yahoo Finance からリアルタイムで取得されます
• ユーザーを追跡しません：個人情報を収集または保存しません
• レート制限：API の不正使用を防ぐ保護機能を内蔵
• エラーの分離：エラーがサーバー全体のクラッシュを引き起こしません

🤝 貢献

貢献を歓迎します！以下の方法でご協力いただけます。

1. リポジトリをフォークする
2. 機能ブランチを作成する：git checkout -b feature/amazing-feature
3. 変更を加え、テストを追加する
4. テストスイートを実行する：pytest
5. コードをフォーマットする：black finance_mcp/
6. プルリクエストを送信する

貢献できる分野

• テクニカル指標の追加
• 暗号資産のサポート
• オプションおよび先物データ
• ニュースのセンチメント分析の統合
• パフォーマンスの最適化
• ドキュメントの改善

📋 要件

• Python：3.8 以上
• 依存関係：
  • mcp >= 1.0.0 - Model Context Protocol フレームワーク
  • yfinance >= 0.2.18 - Yahoo Finance API ラッパー
  • pandas >= 2.0.0 - データ操作および分析
  • ta >= 0.10.2 - テクニカル分析ライブラリ

🐛 トラブルシューティング

よくある問題

サーバーが起動しませんか？

# Check if all dependencies are installed
pip install -r requirements.txt

# Test the server manually
finance-mcp-server

シンボルのデータがありませんか？

• 株式シンボルが正しいことを確認します（例：「Apple」ではなく「AAPL」）
• 市場が開いているか確認します（リアルタイムデータに影響します）
• Yahoo Finance で利用できないシンボルもあります

Claude Desktop に接続できませんか？

• 設定 JSON が有効であることを確認します
• コマンドのパスが正しいことを確認します
• Claude Desktop を完全に再起動します
• Claude Desktop のログでエラーメッセージを確認します

ヘルプを利用する

• GitHub Issues：バグを報告する、または機能をリクエストする
• ディスカッション：コミュニティのサポートと質問
• ドキュメント：詳細なドキュメントと例

📄 ライセンス

このプロジェクトは Apache License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

🙏 謝辞

• 無料の金融データを提供する Yahoo Finance
• Model Context Protocol フレームワークを提供する MCP Team
• Technical Analysis Library の貢献者
• インスピレーションとサポートを提供する オープンソースコミュニティ

🔮 ロードマップ

バージョン 1.1.0（近日公開）

• 暗号資産のサポート（Bitcoin、Ethereum など）
• オプションチェーンデータ
• 決算カレンダーの統合
• ニュースのセンチメント分析

バージョン 1.2.0（今後）

• ポートフォリオ追跡機能
• カスタム指標ビルダー
• マルチタイムフレーム分析
• 高度なチャートデータ

バージョン 2.0.0（構想）

• 機械学習による予測
• リスク分析ツール
• バックテストフレームワーク
• プロトレーダー向け機能

---

⭐ スター履歴

---

MCP とトレーディングのコミュニティのために、心を込めて作られました ❤️

会話型 AI にプロフェッショナル水準の金融分析を提供します