# 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](https://docs.astral.sh/uv/) または pip
- Claude Desktop

### Claude Desktop 設定

1. **uvx のパスを確認**

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

2. **設定ファイルを編集**

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

```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 から見つからない場合があります。

3. **Claude Desktop を再起動**

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

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

```bash
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. ログを確認**

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

**2. uvx のパスを確認**

```bash
which uvx
```

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

### SSL証明書エラー

エラーメッセージ:
```
ssl.SSLCertVerificationError: certificate verify failed
```

**解決方法:**

```bash
# 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
```

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

**解決方法:**

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

# Claude Desktop を再起動
```

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

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

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

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

```bash
# 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