@luziadev/mcp-server

암호화폐 가격 데이터를 위한 Model Context Protocol (MCP) 서버입니다. Claude와 같은 AI 어시스턴트에게 Luzia API를 통해 실시간 티커 가격, 거래소 정보 및 OHLCV 기록에 대한 액세스 권한을 제공합니다.

기능

• 여러 거래소(Binance, Coinbase, Kraken, OKX, Bybit)의 실시간 티커 가격

• 기술적 분석을 위한 과거 OHLCV 캔들스틱 데이터

• 시장 정보 및 거래 쌍

• 거래소 상태 및 가용성

요구 사항

• Luzia API 키 (여기서 발급)

원격 연결 (권장)

Luzia를 AI 어시스턴트와 함께 사용하는 가장 빠른 방법은 https://mcp.luzia.dev/mcp에 있는 호스팅된 MCP 서버에 연결하는 것입니다. 설치가 필요 없습니다. URL과 API 키를 붙여넣기만 하면 됩니다.

Claude.ai 웹 / 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 심(shim)을 사용하는 것입니다.

설정 파일을 편집하세요:

• 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일간 1시간 간격으로 Binance의 BTC/USDT OHLCV 캔들을 분석해줘"

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를 참조하세요.