@luziadev/mcp-server

暗号資産価格データ用のModel Context Protocol (MCP) サーバーです。ClaudeのようなAIアシスタントに、Luzia APIからリアルタイムのティッカー価格、取引所情報、OHLCV履歴へのアクセスを提供します。

機能

• 複数の取引所（Binance、Coinbase、Kraken、OKX、Bybit）からのリアルタイムティッカー価格

• テクニカル分析用の過去のOHLCVローソク足データ

• 市場情報および取引ペア

• 取引所のステータスと可用性

要件

• Luzia APIキー (こちらから取得)

リモート接続（推奨）

LuziaをAIアシスタントで利用する最も速い方法は、ホストされているMCPサーバー https://mcp.luzia.dev/mcp に接続することです。インストールは不要です。URLとAPIキーを貼り付けるだけです。

Claude.ai web / Anthropicコンソール

設定 → インテグレーション → カスタムMCPを追加:

• URL: https://mcp.luzia.dev/mcp

• 認証: Bearerトークン — APIキー (lz_...) を貼り付けます

Claude Desktop (mcp-remote経由)

Claude DesktopのネイティブなリモートMCPサポートは現在順次展開中のため、現時点で最も簡単な方法は、リモートHTTP MCPをClaude Desktopのstdioインターフェースにブリッジする mcp-remote シムを使用することです。

設定ファイルを編集します:

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

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "luzia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.luzia.dev/mcp",
        "--header",
        "Authorization:Bearer lz_your_api_key"
      ]
    }
  }
}

Claude Desktopを再起動（macOSではCmd+Q）して、質問を開始してください。

VS Code, Cursor, Cline, Continue.dev

ツールのMCP設定にURLとAuthorizationヘッダーを貼り付けます:

• URL: https://mcp.luzia.dev/mcp

• ヘッダー: Authorization: Bearer lz_your_api_key

MCP Inspector

npx @modelcontextprotocol/inspector

次に、インスペクターで https://mcp.luzia.dev/mcp を指定し、Authorization: Bearer lz_... ヘッダーを追加します。

ローカルインストール（上級者向け）

サーバーをローカルで実行したい場合、@luziadev/mcp-server はnpmで提供されており、stdio経由で動作します。

# Run directly with npx (no install needed)
LUZIA_API_KEY=lz_your_api_key npx -y @luziadev/mcp-server --stdio

Claude Desktop設定 (ローカルstdio)

{
  "mcpServers": {
    "luzia": {
      "command": "npx",
      "args": ["-y", "@luziadev/mcp-server", "--stdio"],
      "env": {
        "LUZIA_API_KEY": "lz_your_api_key"
      }
    }
  }
}

Claude Code設定 (ローカルstdio)

.claude/settings.json に追加します:

{
  "mcpServers": {
    "luzia": {
      "command": "npx",
      "args": ["-y", "@luziadev/mcp-server", "--stdio"],
      "env": {
        "LUZIA_API_KEY": "lz_your_api_key"
      }
    }
  }
}

利用可能なツール

利用可能なプロンプト

プロンプトは、データを取得して構造化された洞察を生成する、あらかじめ構築された分析テンプレートです。MCPプロンプトをサポートするクライアント（例：/ メニュー経由のClaude Desktop）で利用可能です。

注: Claude CodeはMCPプロンプトを直接サポートしていません。代わりに自然言語（例：「BinanceのBTC/USDTの価格変動を分析して」）を使用してください。自動的に基盤となるツールが呼び出されます。

プロンプトの例

analyze_price_movement

現在のティッカーデータを取得し、買値・売値のスプレッド、24時間統計、出来高を分析します。

引数:

• exchange (必須): 例: "binance", "coinbase"

• symbol (必須): 例: "BTC/USDT", "ETH/USD"

Claude Desktop: / を入力 → analyze_price_movement を選択 → exchange: binance, symbol: BTC/USDT を入力

自然言語 (任意のクライアント): 「Binanceの現在のBTC/USDTの価格変動を分析して」

analyze_ohlcv

過去のローソク足データを取得し、トレンド、サポート/レジスタンス、出来高パターン、ローソク足パターンを含むテクニカル分析を要求します。

引数:

• exchange (必須): 例: "binance"

• symbol (必須): 例: "BTC/USDT"

• interval (任意): "1m", "5m", "15m", "1h", "1d" (デフォルト: "1h")

• period (任意): 例: "24h", "7d", "30d" (デフォルト: "24h")

Claude Desktop: / を入力 → analyze_ohlcv を選択 → exchange: binance, symbol: BTC/USDT, interval: 1h を入力

自然言語 (任意のクライアント): 「過去7日間のBinanceのBTC/USDTのOHLCVローソク足を1時間間隔で分析して」

compare_exchanges

複数の取引所からティッカーデータを取得し、アービトラージ分析のために価格、スプレッド、流動性を比較します。

引数:

• symbol (必須): 例: "BTC/USDT"

• exchanges (任意): カンマ区切りのリスト、例: "binance,coinbase,kraken" (デフォルト: "binance,coinbase,kraken")

Claude Desktop: / を入力 → compare_exchanges を選択 → symbol: BTC/USDT を入力

自然言語 (任意のクライアント): 「すべての取引所でBTC/USDTの価格を比較して」

レート制限

Luziaのサブスクリプションティアに基づきます:

• 無料: 100リクエスト/分、5,000リクエスト/日

• Pro: 1,000リクエスト/分、20,000リクエスト/日

トラブルシューティング

"Unauthorized" エラー

• リモート: Authorization: Bearer lz_... ヘッダーが設定されており、キーが lz_ で始まっていることを確認してください。

• Stdio: MCPクライアント設定で LUZIA_API_KEY が設定されており、キーが取り消されていないことを確認してください。

リモートセッションエラー

• クライアントが "Unknown session id" を報告する場合、サーバーが再起動されたか、セッションが期限切れ（30分間アイドル）になっています。再接続すると、クライアントは自動的に再初期化されます。

Claude Desktopがサーバーを見つけられない (stdio)

• claude_desktop_config.json が有効なJSONであることを確認してください。

• Node.js 20以上がインストールされていることを確認してください (node --version)。

• Claude Desktopを完全に再起動してください（macOSではCmd+Q）。

ライセンス

MIT - 詳細は LICENSE を参照してください。