MCP 문서 관리

메뉴

홈
문서 목록
관리자 로그인

문서 정보

최종 수정일:
2025-05-13 10:49
태그:
#MCP #써드파티 #암호화폐 #거래소 #결제

Coinbase

Coinbase

Coinbase MCP 서버는 AI 에이전트가 Coinbase 거래소 API 및 Coinbase Commerce 결제 시스템과 상호작용할 수 있게 해주는 서비스입니다. 이 서버를 통해 암호화폐 시장 데이터 조회, 계정 잔액 확인, 거래 실행, 결제 링크 생성 등 다양한 기능을 AI 에이전트에서 직접 사용할 수 있습니다.

특징

  • 시장 데이터 접근: 암호화폐 가격, 거래량, 오더북 등 실시간 시장 데이터에 접근할 수 있습니다.
  • 거래 실행: 적절한 API 키와 권한이 구성되면 AI 에이전트가 거래를 실행할 수 있습니다.
  • 결제 링크 생성: Coinbase Commerce를 통해 암호화폐 결제 링크를 생성하고 관리할 수 있습니다.
  • 계정 정보 조회: 계정 잔액, 거래 내역, 보유 자산 등의 정보를 조회할 수 있습니다.
  • 다중 암호화폐 지원: 비트코인, 이더리움, 솔라나, 에이다 등 Coinbase에서 지원하는 다양한 암호화폐를 처리할 수 있습니다.
  • 온램프 기능: 법정화폐에서 암호화폐로 자금을 온램핑하는 URL을 제공합니다.

API

리소스

  • 시장 데이터: 암호화폐 가격, 거래량, 오더북 등 시장 관련 데이터를 제공합니다.
  • 계정 정보: 사용자 계정 잔액, 거래 내역, 보유 자산 등의 정보를 제공합니다.
  • 결제 정보: Coinbase Commerce로 생성된 결제 정보를 제공합니다.

도구

시장 데이터 도구

  • get_ticker: 특정 암호화폐 쌍의 현재 시장 가격 정보를 조회합니다.
  • 입력: 암호화폐 쌍(예: BTC-USD)

  • 출력: 현재 가격, 24시간 변동폭, 거래량 등 시장 정보

  • get_order_book: 특정 암호화폐 쌍의 주문장(오더북) 정보를 조회합니다.

  • 입력: 암호화폐 쌍, 깊이(선택)

  • 출력: 매수/매도 주문 목록, 주문량, 가격대 정보

  • get_market_trades: 특정 암호화폐 쌍의 최근 거래 내역을 조회합니다.

  • 입력: 암호화폐 쌍, 제한 수(선택)
  • 출력: 최근 거래 목록(가격, 수량, 시간 등)

계정 관리 도구

  • get_account_balance: 사용자 계정의 암호화폐 잔액 정보를 조회합니다.
  • 입력: 암호화폐 심볼(선택)

  • 출력: 잔액, 가용 자금, 보류 자금 정보

  • get_transaction_history: 사용자 계정의 거래 내역을 조회합니다.

  • 입력: 시작 날짜, 종료 날짜(선택), 암호화폐 심볼(선택)
  • 출력: 거래 내역 목록(시간, 유형,, 금액 등)

거래 실행 도구

  • place_order: 암호화폐 매수/매도 주문을 실행합니다.
  • 입력: 암호화폐 쌍, 주문 유형(시장가/지정가), 방향(매수/매도), 수량, 가격(지정가의 경우)

  • 출력: 주문 ID, 상태, 세부 정보

  • cancel_order: 기존 주문을 취소합니다.

  • 입력: 주문 ID
  • 출력: 취소 상태, 세부 정보

Coinbase Commerce 도구

  • create_charge: 암호화폐 결제를 위한 청구를 생성합니다.
  • 입력: 금액, 통화, 설명, 메타데이터(선택)

  • 출력: 결제 링크, 청구 ID, 상태

  • get_charge_info: 특정 청구의 정보를 조회합니다.

  • 입력: 청구 ID

  • 출력: 청구 상태, 결제 정보, 만료 시간 등

  • list_charges: 생성된 청구 목록을 조회합니다.

  • 입력: 제한 수(선택), 시작 날짜(선택)
  • 출력: 청구 목록 및 각 청구의 요약 정보

Base Network 도구 (Base MCP)

  • get_onramp_url: Coinbase를 통해 자금을 온램핑하기 위한 URL을 얻습니다.
  • 입력: 없음 또는 옵션

  • 출력: 온램핑 URL

  • get_erc20_balance: ERC20 토큰의 잔액을 조회합니다.

  • 입력: 토큰 계약 주소, 지갑 주소

  • 출력: 토큰 잔액 정보

  • transfer_erc20: ERC20 토큰을 다른 주소로 전송합니다.

  • 입력: 토큰 계약 주소, 수신자 주소, 금액
  • 출력: 트랜잭션 해시, 상태

사용 방법

Coinbase MCP 서버를 사용하려면 다음 단계를 따릅니다:

  1. Coinbase API 키 생성:
  2. Coinbase 계정에서 API 키를 생성합니다.

  3. 필요한 권한(읽기 전용 또는 거래 권한)을 설정합니다.

  4. 서버 설치 및 구성:

  5. CCXT MCP 서버 또는 Coinbase Commerce MCP 서버를 설치합니다. 

    # CCXT MCP 서버 설치 예시
git clone https://github.com/example/ccxt-mcp-server.git
cd ccxt-mcp-server
pip install -e .

  6. 환경 변수 설정: 

    export COINBASE_API_KEY="your_api_key"
export COINBASE_API_SECRET="your_api_secret"
export COINBASE_COMMERCE_API_KEY="your_commerce_api_key"

  7. Claude Desktop에서 설정 구성: 

    {
  "mcpServers": {
    "coinbase": {
      "command": "ccxt-mcp",
      "args": ["--exchange", "coinbase"],
      "env": {
        "COINBASE_API_KEY": "your_api_key",
        "COINBASE_API_SECRET": "your_api_secret"
      }
    },
    "coinbase-commerce": {
      "command": "node",
      "args": ["/path/to/mcp-coinbase-commerce/dist/index.js"],
      "env": {
        "COINBASE_COMMERCE_API_KEY": "your_commerce_api_key"
      }
    }
  }
}

보안 고려사항

Coinbase MCP 서버를 사용할 때 다음 보안 고려사항에 주의해야 합니다:

  1. API 권한 제한: API 키에는 필요한 최소한의 권한만 부여하세요. 읽기 전용 작업에는 거래 권한이 필요하지 않습니다.

  2. 자금 제한: 사용 중인 API 키에 자금 인출 제한을 설정하세요.

  3. IP 제한: 가능한 경우 특정 IP 주소에서만 API 키를 사용할 수 있도록 제한하세요.

  4. 환경 변수 보호: API 키와 비밀은 환경 변수 또는 안전한 자격 증명 관리자를 통해 관리하고, 하드코딩하지 마세요.

  5. 거래 전 확인: 자동화된 거래를 실행하기 전에 사용자에게 확인을 요청하는 메커니즘을 구현하세요.

사용 사례

Coinbase MCP 서버는 다음과 같은 시나리오에서 특히 유용합니다:

  1. 시장 분석: 실시간 시장 데이터와 과거 데이터를 분석하여 시장 동향, 가격 패턴을 파악합니다.

  2. 포트폴리오 추적: 사용자의 암호화폐 포트폴리오를 추적하고 성과를 분석합니다.

  3. 자동화된 거래: 사용자가 정의한 전략에 따라 자동으로 거래를 실행합니다(API 거래 권한이 필요).

  4. 결제 시스템 통합: 웹사이트나 앱에 암호화폐 결제 기능을 통합합니다.

  5. 온체인 상호작용: Base 네트워크와 상호작용하여 스마트 계약 호출, 토큰 전송 등을 수행합니다.

연결된 구성 요소