Stock Market MCP Server

Stock Market MCP Server

Finnhub API を使用して株式市場データと分析ツールを提供する Machine Conversation Protocol（MCP）サーバーです。

特長

• 株式シンボルの検索
• リアルタイムの株価
• 基本的な財務指標
• 市場および企業のニュース
• 過去の価格データ（ローソク足）
• 一般的な分析タスク向けの組み込みプロンプト

前提条件

• Python 3.8 以降
• uv - 高速な Python パッケージインストーラーおよび依存関係解決ツール
• Finnhub API キー（finnhub.io で無料で取得できます）
• Claude Desktop（Claude で MCP サーバーを使用する場合）

セットアップ手順

1. リポジトリをクローンする

git clone https://github.com/yourusername/stock-market-mcp-server.git
cd stock-market-mcp-server

2. uv で環境をセットアップする

uv は高速で信頼性の高い Python パッケージインストーラーおよび仮想環境マネージャーです。環境をセットアップする手順は次のとおりです。

# Install uv if you don't have it already
pip install uv

# Create a virtual environment
uv venv

# Activate the virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
# .venv\Scripts\activate

# Install dependencies
uv add -r requirements.txt

3. 環境変数を設定する

プロジェクトのルートに .env.local ファイルを作成し、Finnhub API キーを設定します。

FINNHUB_API_KEY=your_api_key_here

your_api_key_here を実際の Finnhub API キーに置き換えてください。

MCP サーバーの実行

MCP サーバーを起動するには、次のコマンドを実行します。

uv run stock-market-server.py

サーバーはデフォルトで stdio モードで実行されます。これは、標準入力から読み取り、標準出力に書き込むことを意味します。

Claude Desktop での使用

この MCP サーバーを Claude Desktop で使用するには、次の手順に従います。

1. Claude Desktop を起動します
2. Settings > Developer に移動します
3. 「Developer Mode」を有効にします
4. 「Add Tool」をクリックします
5. 「Local MCP Server」を選択します
6. ツールを設定します。
   • Name: Stock Market
   • Command: Python 実行ファイルとスクリプトの完全なパス
     • 例：/Users/username/.venv/bin/python /Users/username/stock-market-mcp-server/stock-market-server.py
   • Working Directory: プロジェクトディレクトリの完全なパス
7. 「Save」をクリックします

これで、Claude との会話で株式市場ツールを使用できます。

または、Claude Desktop のツールリストに手動でツールを追加することもできます。 設定ファイルは Claude Desktop のインストールディレクトリにあります。MacBook Pro の場合は、 ~/Library/Application\ Support/Claude/claude_desktop_config.json にあります。 次の JSON を tools 配列に追加してください。パスはご利用の環境に合わせて変更してください。

"stock-market": {
   "command": "uv",
   "args": [
     "--directory",
     "<YOUR_PATH_GOES_HERE>/stock-market-mcp-server",
     "run",
     "stock_market_server.py"
   ]
 }

Stock Market Client での使用

Stock Market Client で MCP サーバーを使用するには、次の手順に従います。

1. Anthropic API キーが必要です。Anthropic で無料で取得できます。
2. .env ファイルを API キーで更新します。 ANTHROPIC_API_KEY=your_api_key_here
3. 次のコマンドで MCP クライアントを起動します。 uv run stock_market_client.py

利用可能なツール

MCP サーバーでは、次のツールを利用できます。

• get_stock_symbol_lookup：企業名から株式シンボルを検索します
• get_stock_price：株式の最新価格を取得します
• get_basic_financials：企業の主要な財務指標を取得します
• get_market_news：カテゴリー別に最新の市場ニュースを取得します
• get_company_news：指定した期間の特定企業のニュースを取得します
• get_stock_candles：株式の過去の価格データを取得します

利用可能なプロンプト

サーバーには、次の組み込みプロンプトが含まれています。

• stock_analysis：投資候補として株式を分析します
• market_overview：包括的な市場概況を取得します
• stock_price_history：過去の価格変動を分析します
• company_news_analysis：ニュースと株価への影響を分析します

使用例のプロンプト

Claude でツールを使用する例をいくつか紹介します。

1. 株式シンボルを検索する： 「Apple の株式シンボルを調べてもらえますか？」

2. 現在の株価を取得する： 「AAPL の現在の株価はいくらですか？」

3. プロンプトを使用する： 「投資候補として Tesla の株式を分析したいです。」

4. 複数のツールを組み合わせる： 「最新ニュースと AAPL、MSFT、TSLA の現在の株価を含む市場概況を教えてください。」

トラブルシューティング

• APIキーの問題：Finnhub APIキーが .env.local ファイルに正しく設定されていることを確認してください
• モジュールが見つからないエラー：仮想環境が有効化され、すべての依存関係がインストールされていることを確認してください
• 接続の問題：インターネット接続とFinnhub APIのステータスを確認してください

ライセンス

MITライセンス