Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Market Index MCPcompare the S&P 500 and NASDAQ 100 performance for 2023"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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はどこまで上がった？」
提供ツール
ツール名 | 説明 |
| 利用可能な銘柄一覧を取得 |
| 指定期間の価格範囲（最高値・最安値・平均）を取得 |
| 特定日の価格データを取得 |
| 複数銘柄のパフォーマンスを比較 |
| 指定年の下落日ワーストランキング |
| 指定年の上昇日ベストランキング |
| 年間サマリー（年初来リターンなど） |
トラブルシューティング
サーバーが起動しない（Server disconnected）
1. ログを確認
cat ~/Library/Logs/Claude/mcp-server-market-index.log | tail -502. 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