How do I use Market Index MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Market Index MCP compare 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はどこまで上がった？」

提供ツール

ツール名	説明
`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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Market Index MCP

Market Index MCP

特徴

対応銘柄

インストール

前提条件

Claude Desktop 設定

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

使用例

提供ツール

トラブルシューティング

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

SSL証明書エラー

"Unexpected token" エラー

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

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

技術詳細

アーキテクチャ

データ更新

ライセンス

Resources

New MCP Servers

Latest Blog Posts

MCP directory API