# stooq-mcp
[English](README.md)
Rust で実装された MCP (Model Context Protocol) サーバーです。[stooq.com](https://stooq.com) から株価データを取得します。
## デモ
https://github.com/user-attachments/assets/72b4b865-5073-4d04-b5d0-ed109600e021
## 機能
- **最新株価取得** - リアルタイムの株価データを取得
- **履歴データ取得** - 日付範囲を指定して過去の株価データを取得
- **複数市場対応** - 5つの主要市場の株式にアクセス可能
## 対応市場
| 市場コード | 国名 |
|------------|------|
| `jp` | 日本 |
| `us` | アメリカ |
| `uk` | イギリス |
| `hk` | 香港 |
| `de` | ドイツ |
## インストール
### 前提条件
- Rust 1.75+
- Cargo
### ワンライナーインストール
```bash
curl -fsSL https://raw.githubusercontent.com/hoqqun/stooq-mcp/main/install.sh | bash
```
`~/.stooq-mcp/` にインストールされます。カスタマイズする場合：
```bash
STOOQ_MCP_DIR=/your/path curl -fsSL https://raw.githubusercontent.com/hoqqun/stooq-mcp/main/install.sh | bash
```
### クイックインストール
```bash
git clone https://github.com/hoqqun/stooq-mcp.git
cd stooq-mcp
./install.sh
```
インストールスクリプトは以下を実行します：
1. プロジェクトのビルド
2. Claude Code / Claude Desktop への登録
### 手動ビルド
```bash
cargo build --release
```
バイナリは `./target/release/stooq-mcp` に生成されます。
## 使い方
### Claude Code
Claude Code に MCP サーバーを登録します：
```bash
claude mcp add stooq-mcp /path/to/stooq-mcp/target/release/stooq-mcp
```
### Claude Desktop
Claude Desktop の設定ファイルに以下を追加します：
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
**Linux**: `~/.config/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"stooq-mcp": {
"command": "/path/to/stooq-mcp/target/release/stooq-mcp"
}
}
}
```
## ツール
### `get_stock_price`
stooq.com から株価データを取得します。
#### パラメータ
| パラメータ | 型 | 必須 | 説明 |
|-----------|------|------|------|
| `ticker` | string | ✅ | 銘柄コード（例: `"7203"`, `"AAPL"`） |
| `market` | string | ✅ | 市場コード: `jp`, `us`, `uk`, `hk`, `de` |
| `start_date` | string | ❌ | 開始日 `YYYYMMDD` 形式（例: `"20240101"`） |
| `end_date` | string | ❌ | 終了日 `YYYYMMDD` 形式（例: `"20241231"`） |
## 使用例
### 最新株価を取得
**トヨタ自動車（日本）:**
```
トヨタ（7203）の現在の株価を取得して。
```
**Apple（アメリカ）:**
```
AAPLの最新株価を教えて。
```
### 履歴データを取得
**ソニー（日本）- 2024年通年:**
```
ソニー（6758）の2024年1月1日から12月31日までの株価履歴を取得して。
```
### レスポンス形式
**最新データ:**
```csv
Symbol,Date,Time,Open,High,Low,Close,Volume
7203.JP,2024-12-27,16:00:00,2500,2520,2480,2510,1000000
```
**履歴データ:**
```csv
Date,Open,High,Low,Close,Volume
2024-01-04,2450,2480,2440,2470,800000
2024-01-05,2470,2490,2460,2485,750000
...
```
## 技術スタック
- **Rust** - システムプログラミング言語
- **[rmcp](https://crates.io/crates/rmcp)** - MCP サーバー実装
- **[reqwest](https://crates.io/crates/reqwest)** - HTTP クライアント
- **[tokio](https://crates.io/crates/tokio)** - 非同期ランタイム
## 制限事項
> ⚠️ **重要なお知らせ**
- stooq.com は**非公式 API** であり、予告なく変更される可能性があります
- **日次レート制限**があります - 過度なリクエストはブロックされる可能性があります
- **個人利用・学習目的**のみを想定しています
- データの正確性は保証されません
## ライセンス
MIT License - 詳細は [LICENSE](LICENSE) を参照してください。
## コントリビューション
コントリビューションは大歓迎です！お気軽にプルリクエストをお送りください。
