bitbank-mcp-server

bitbank API のデータを使った暗号資産市場分析を、Claude（LLM）から簡単に実行できる MCP サーバーです。

本 MCP サーバーについて

この MCP サーバーは、bitbank の公開 API から価格・取引データを取得し、LLM が安定して質の高い分析を行えるよう最適化された「分析ツール」を提供します。生データをそのまま LLM に渡すだけではなく、指標の計算・統合・可視化を「分析ツール」も備えています。各ツールの description では「いつ使うべきか」「他ツールとの使い分け」を明示し、LLM が適切なツールを自律的に選択できるよう設計しています。

概要

bitbank の公開 API から価格・板情報・約定履歴・ローソク足データを取得し、以下の分析を実行できます。 → 全ツールの一覧と使い分けは docs/tools.md を参照。

取得できるデータ

リアルタイム価格（ティッカー）
板情報（オーダーブック）
約定履歴（売買方向・時刻）
ローソク足（1分足〜月足）

実行できる分析

テクニカル指標（SMA/RSI/ボリンジャーバンド/一目均衡表/MACD）
フロー分析（買い/売りの勢い・CVD・スパイク検出）
ボラティリティ分析（RV/ATR）
板の圧力分析（価格帯ごとの買い/売り圧力）
パターン検出（ダブルトップ/ヘッドアンドショルダーズ等）
総合スコア判定（複数指標を統合した強弱判定）
- 長期パターンの現在地関連検出（detect_patterns: requireCurrentInPattern/currentRelevanceDays）

視覚化

ローソク足・一目均衡表・ボリンジャーバンド等のチャートを SVG 形式で生成
- ※現状 LLM が自力でローソク足とインジケーターを重ねたチャートを描画するのは難しいため、完成した SVG を提供することで可視化をサポートしています。

クイックスタート（3 ステップ）

1. インストール

git clone https://github.com/tjackiet/bitbank-genesis-mcp-server.git
cd bitbank-genesis-mcp-server
npm install

2. Claude Desktop に登録（最短）

~/Library/Application Support/Claude/claude_desktop_config.json に以下を追加:

{
  "mcpServers": {
    "bitbank": {
      "command": "/usr/local/bin/node",
      "args": [
        "/ABS/PATH/to/node_modules/tsx/dist/cli.mjs",
        "/ABS/PATH/to/src/server.ts"
      ],
      "workingDirectory": "/ABS/PATH/to/project",
      "env": { "LOG_LEVEL": "info", "NO_COLOR": "1" }
    }
  }
}

/ABS/PATH/to/ を実際のプロジェクトパスに置き換えてください
⚠️ macOS では Desktop フォルダに配置すると権限エラーが発生する場合があります（ホームディレクトリ直下を推奨）
追加後、Claude Desktop を Cmd+Q で完全終了して再起動してください
Node.js 18+ があれば Docker は不要です（Docker起動）

表示名のカスタマイズ

Claude Desktop の UI に表示される名前は claude_desktop_config.json のキー名で決まります：

{
  "mcpServers": {
    "ビットバンクMCP": {  // ← この名前がUIに表示される
      "command": "...",
      "args": ["..."]
    }
  }
}

日本語名も使用可能です。

設定ファイルの場所：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

3. 使ってみる

Claude にそのまま話しかけます:

BTCの今の市場状況を分析して
ビットコインは買いと売りどちらが優勢？
直近 1 週間でテクニカル的に上向きの仮想通貨を 3 つ教えて

💡 何を聞けばいいかわからない場合: 用意されたプロンプト集をご覧ください。初心者向け（🔰）から中級者向けまで、11種類の分析プロンプトを用意しています。

🌅 朝のルーティンに: 「おはようレポート（直近8時間）」で、寝ている間の相場変動をすばやくキャッチアップできます。

使用例（会話の型）

「今、BTC は買いですか？」→ analyze_market_signal: 総合スコア + 寄与度・根拠
「直近で MACD クロスした銘柄は？」→ detect_macd_cross: スクリーニング結果
「ここ 30 日のボラ推移を見たい」→ get_volatility_metrics + render_chart_svg

チャート表示（SVG）

MCP クライアント（Claude）では、アーティファクトとして data.svg を表示するようにお願いしてください。
- Claude で LLM がうまくアーティファクトを出力できない場合は、以下のプロンプトを加えるのがおすすめです。
  - 「identifier と title を追加して、アーティファクトとして表示して」
- 既定の描画は「ロウソク足のみ」。ボリンジャーバンド等のオーバーレイは明示指定時に追加されます（BBは --bb-mode=default 指定時に ±2σ がデフォルト）。

パターン検出の新機能

detect_patterns（統合版）:
- 完成済み・形成中パターンを一括検出（全13パターン対応）
- includeForming（bool, 既定 false）: 形成中パターンを含める
- includeCompleted（bool, 既定 true）: 完成済みパターンを含める
- includeInvalid（bool, 既定 false）: 無効化パターンを含める
- requireCurrentInPattern（bool, 既定 false）: パターン終了が直近 N 日以内のものに限定
- currentRelevanceDays（int, 既定 7）: 直近とみなす日数
- 形成中パターンは3ヶ月以内に制限

詳細ドキュメント

プロンプト集（初心者〜中級者向け）: docs/prompts-table.md
ツール一覧と使い分け: docs/tools.md
開発者向けガイド（スキーマ同期・型生成・CI など）: CONTRIBUTING.md
運用・監視（ログ集計／Docker起動ほか）: docs/ops.md

よくある質問（FAQ）

Q. 何を聞けばいいかわからない プロンプト集を参照してください。初心者向け🔰から中級者向けまで11種類の分析プロンプトを用意しています。

Q. Docker は必須？ いいえ。Node 18+ でローカル実行できます（最短は Claude Desktop 登録）。

Q. API キーは必要？ いいえ。現状 bitbank の公開 API のみ使用します。

Q. どのツールを使えばよい？ まず analyze_market_signal で全体を把握 → 必要に応じて各専門ツールへ。

Q. 対応銘柄は固定？ 固定ではありません。上流の公開 API が返す銘柄に自動追随します（追加/廃止も自動反映）。参考: bitbank 公開API仕様

Q. MCP Inspector でも試せる？ はい。開発時は次で実行できます。

npx @modelcontextprotocol/inspector -- tsx src/server.ts

補足: HTTP サーバは既定で無効です（STDIO 汚染を避けるため）。HTTP を使う場合のみ MCP_ENABLE_HTTP=1 PORT=8787 を設定し、npx @modelcontextprotocol/inspector http://localhost:8787/mcp で接続してください。