market-index-mcp by tamappe - MCP Server

Market Index MCP

S&P500、NASDAQ100、日経225などの市場指標データを自然言語で検索できるMCPサーバー

特徴

約100年分の市場データ（77,870件）を即座に検索
Claude Desktop と統合 - 自然言語で質問するだけ
初回起動時に自動セットアップ - 設定不要
ローカルキャッシュ - 高速クエリ（2-15ms）

対応銘柄

シンボル	名称	データ期間
^GSPC	S&P 500	1927年〜
^NDX	NASDAQ 100	1985年〜
^DJI	Dow Jones	1992年〜
^N225	Nikkei 225	1965年〜
^FTSE	FTSE 100	1984年〜
^VIX	VIX (恐怖指数)	1990年〜

インストール

前提条件

Python 3.10 以上
uv または pip
Claude Desktop

Claude Desktop 設定

uvx のパスを確認

which uvx
# 例: /opt/homebrew/bin/uvx

設定ファイルを編集

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "market-index": {
      "command": "/opt/homebrew/bin/uvx",
      "args": [
        "--from", "git+https://github.com/tamappe/market-index-mcp.git",
        "market-index-mcp"
      ]
    }
  }
}

重要: command には uvx のフルパスを指定してください。相対パス "uvx" だと Claude Desktop から見つからない場合があります。

Claude Desktop を再起動

初回起動時にデータを自動ダウンロード（約10MB、30秒程度）します。

手動インストール（開発用）

git clone https://github.com/tamappe/market-index-mcp.git
cd market-index-mcp
pip install -e .

# 実行
market-index-mcp

使用例

Claude Desktop で以下のような質問ができます：

「S&P500の2020年3月の最安値と最高値を教えて」
「2020年のS&P500とNASDAQ100を比較して」
「2008年のダウ平均ワースト下落日トップ5は？」
「日経225の2023年の年間リターンは？」
「コロナショック時のVIXはどこまで上がった？」

提供ツール

ツール名	説明
`list_symbols`	利用可能な銘柄一覧を取得
`get_price_range`	指定期間の価格範囲（最高値・最安値・平均）を取得
`get_price_on_date`	特定日の価格データを取得
`compare_symbols`	複数銘柄のパフォーマンスを比較
`get_worst_days`	指定年の下落日ワーストランキング
`get_best_days`	指定年の上昇日ベストランキング
`get_yearly_summary`	年間サマリー（年初来リターンなど）

トラブルシューティング

サーバーが起動しない（Server disconnected）

1. ログを確認

cat ~/Library/Logs/Claude/mcp-server-market-index.log | tail -50

2. uvx のパスを確認

which uvx

設定ファイルの command にフルパスを指定しているか確認してください。

SSL証明書エラー

エラーメッセージ:

ssl.SSLCertVerificationError: certificate verify failed

解決方法:

# Python 3.12 の場合
sudo /Library/Frameworks/Python.framework/Versions/3.12/bin/python3.12 -m pip install --upgrade certifi

# または Install Certificates コマンドを実行
/Applications/Python\ 3.12/Install\ Certificates.command

"Unexpected token" エラー

エラーメッセージ:

MCP market-index: Unexpected token '📊', "📊 初回起動: デ"... is not valid JSON

これは古いバージョンの問題です。最新版では修正済みです。

解決方法:

# uvx キャッシュをクリア
rm -rf ~/.cache/uv/archive-v0/

# Claude Desktop を再起動

データダウンロードに失敗する

GitHub Releases からデータを取得できない場合：

ネットワーク接続を確認
https://github.com/tamappe/market-index-mcp/releases にアクセスできるか確認
プロキシ環境の場合は環境変数を設定

キャッシュを完全にクリアしたい

# uvx キャッシュ
rm -rf ~/.cache/uv/

# Claude Desktop を再起動

技術詳細

アーキテクチャ

Database (データ管理)
    ↓ GitHub Actions (平日9時自動更新)
GitHub Releases (market_data.json)
    ↓ 初回起動時にダウンロード
SQLite (ローカルキャッシュ)
    ↓
MCP Server → Claude Desktop

データ更新

GitHub Actions で平日 JST 9:00 に自動更新
Supabase から最新データを取得し、GitHub Releases に反映
MCPサーバー再起動時に自動で最新版を取得

ライセンス

MIT