Which integrations are available for this server?

Generates visual market analysis charts, including candlestick charts and technical indicators such as Bollinger Bands and Ichimoku Kinko Hyo, in SVG format for visualization.

How do I use bitbank-mcp-server?

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., "@bitbank-mcp-server Show me a BTC market analysis and a chart with Bollinger Bands" 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.

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 で接続してください。