@luziadev/mcp-server

Сервер протокола контекста модели (MCP) для данных о ценах на криптовалюту. Предоставляет ИИ-ассистентам, таким как Claude, доступ в реальном времени к котировкам, информации о биржах и историческим данным OHLCV из API Luzia.

Возможности

• Котировки в реальном времени с нескольких бирж (Binance, Coinbase, Kraken, OKX, Bybit)

• Исторические данные свечей OHLCV для технического анализа

• Рыночная информация и торговые пары

• Статус и доступность бирж

Требования

• API-ключ Luzia (получить можно здесь)

Удаленное подключение (рекомендуется)

Самый быстрый способ использовать Luzia с вашим ИИ-ассистентом — подключиться к нашему хостинг-серверу MCP по адресу https://mcp.luzia.dev/mcp. Установка не требуется. Просто вставьте URL и ваш API-ключ.

Claude.ai web / Консоль Anthropic

Настройки → Интеграции → Добавить пользовательский MCP:

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

• Аутентификация: Bearer token — вставьте ваш API-ключ (lz_...)

Claude Desktop (через mcp-remote)

Нативная поддержка удаленного MCP в Claude Desktop все еще находится в стадии внедрения, поэтому самый простой путь сегодня — это прослойка mcp-remote, которая связывает удаленный HTTP MCP с интерфейсом stdio Claude Desktop.

Отредактируйте ваш конфиг:

• 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 (Cmd+Q на macOS) и начните задавать вопросы.

VS Code, Cursor, Cline, Continue.dev

Вставьте URL и заголовок Authorization в настройки MCP для вашего инструмента:

• 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 напрямую — используйте естественный язык (например, "Проанализируй движение цены BTC/USDT на Binance"), и он автоматически вызовет нужные инструменты.

Примеры промптов

analyze_price_movement

Извлекает текущие данные котировок и анализирует спред бид-аск, статистику за 24 часа и объем.

Аргументы:

• exchange (обязательно): например, "binance", "coinbase"

• symbol (обязательно): например, "BTC/USDT", "ETH/USD"

Claude Desktop: Введите / → выберите analyze_price_movement → заполните exchange: binance, symbol: BTC/USDT

Естественный язык (любой клиент): "Проанализируй текущее движение цены BTC/USDT на Binance"

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

Естественный язык (любой клиент): "Проанализируй свечи OHLCV BTC/USDT на Binance с интервалом 1ч за последние 7 дней"

compare_exchanges

Извлекает данные котировок с нескольких бирж и сравнивает цены, спреды и ликвидность для арбитражного анализа.

Аргументы:

• symbol (обязательно): например, "BTC/USDT"

• exchanges (опционально): список через запятую, например, "binance,coinbase,kraken" (по умолчанию: "binance,coinbase,kraken")

Claude Desktop: Введите / → выберите compare_exchanges → заполните symbol: BTC/USDT

Естественный язык (любой клиент): "Сравни цены BTC/USDT на всех биржах"

Лимиты запросов

Зависят от вашего тарифного плана Luzia:

• Free: 100 запросов/минуту, 5 000/день

• Pro: 1 000 запросов/минуту, 20 000/день

Устранение неполадок

Ошибки "Unauthorized"

• Удаленно: проверьте, что заголовок Authorization: Bearer lz_... установлен и ключ начинается с lz_.

• Stdio: проверьте, что LUZIA_API_KEY установлен в конфигурации вашего MCP-клиента и что ключ не был отозван.

Ошибки удаленной сессии

• Если клиент сообщает "Unknown session id", сервер был перезагружен или ваша сессия истекла (30 минут простоя). Переподключитесь, и клиент автоматически выполнит повторную инициализацию.

Claude Desktop не может найти сервер (stdio)

• Убедитесь, что claude_desktop_config.json содержит валидный JSON.

• Убедитесь, что установлен Node.js 20+ (node --version).

• Полностью перезапустите Claude Desktop (Cmd+Q на macOS).

Лицензия

MIT — подробности см. в LICENSE.