Luzia Crypto Prices

@luziadev/mcp-server

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

機能

• 複数の取引所（Binance、Coinbase、Kraken、OKX、Bybit）のリアルタイムティッカー価格
• テクニカル分析用の過去のOHLCVローソク足データ
• 市場情報と取引ペア
• 取引所のステータスと利用可能状況

必要条件

• Luzia API キー（こちらから取得）

リモート接続（推奨）

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

Claude.ai Web／Anthropic Console

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

• URL： https://mcp.luzia.dev/mcp
• 認証： Bearerトークン — APIキー（lz_...）を貼り付けます

Claude Desktop（mcp-remote 経由）

Claude DesktopのネイティブなリモートMCPサポートはまだ段階的に展開中のため、現在最も簡単な方法は mcp-remote シムを使うことです。これにより、リモートHTTP MCPをClaude Desktopのstdioインターフェースに橋渡しできます。

設定を編集します：

• 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

次に、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"
      }
    }
  }
}

利用可能なツール

ツール	説明
get_ticker	特定の取引ペアの現在価格を取得します
get_tickers	複数の取引ペア、または取引所のすべてのペアの価格を取得します
get_history	取引ペアの過去のOHLCVローソク足データを取得します
get_exchanges	対応している取引所（CEXおよびDEX）とそのステータスを一覧表示します
get_markets	DEXプールのメタデータを含む、取引所の取引ペアを一覧表示します
get_tokens	検索およびチェーンによるフィルター機能を備えた、標準資産とオンチェーントークンを一覧表示します
get_token	複合ID（crypto:SYMBOL または {chain}:SYMBOL）で単一のトークンを検索します
get_fiat_currencies	市場で参照されるISO 4217法定通貨を一覧表示します

利用可能なプロンプト

プロンプトは、データを取得して構造化された分析情報を生成する、事前に作成された分析テンプレートです。MCPプロンプトに対応したクライアント（例：/ メニューから利用するClaude Desktop）で使用できます。

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

プロンプト	説明
analyze_price_movement	取引ペアの価格変動とトレンドを分析します
analyze_ohlcv	テクニカル分析を用いてOHLCVローソク足データを分析します
compare_exchanges	裁定取引の機会を探すため、取引所間の価格を比較します

プロンプトの例

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 サブスクリプションプランに応じた制限が適用されます：

• 無料： 1 分あたり 25 リクエスト、1 日あたり 1,000 リクエスト
• Pro： 1 分あたり 1,000 リクエスト、1 日あたり 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 を参照してください。