Thirdweb MCP Server

공식

2,000개 이상의 블록체인에 읽기/쓰기가 가능하며, 데이터 쿼리, 컨트랙트 분석/배포, 트랜잭션 실행을 지원합니다. Thirdweb 기반.

GitHub
20

문서

thirdweb MCP 서버

thirdweb 서비스 통합을 위한 모델 컨텍스트 프로토콜(MCP) 서버 구현체입니다. 이 서버를 사용하면 thirdweb의 도구를 모든 MCP 호환 클라이언트와 통합할 수 있습니다.

개요

thirdweb MCP는 표준화된 모델 컨텍스트 프로토콜을 통해 thirdweb의 블록체인 도구 및 서비스 모음에 접근할 수 있는 통합 인터페이스를 제공합니다. 여러 통신 전송 방식을 지원하며 다양한 thirdweb 서비스와 통합할 수 있습니다:

  • Nebula: 자율적 온체인 실행 - 실시간 온체인 분석, 코드 생성 및 컨트랙트 상호작용
  • Insight: 실시간 온체인 데이터를 위한 블록체인 데이터 분석 기능
  • Engine: 컨트랙트 배포 및 상호작용을 위한 thirdweb 백엔드 인프라와의 통합
  • EngineCloud: 서버 지갑, 컨트랙트 상호작용 및 트랜잭션 관리를 위한 클라우드 기반 엔진 작업
  • Storage: IPFS를 통한 데이터 업로드 및 조회를 위한 탈중앙화 스토리지 기능

설치

사전 요구 사항

  • Python 3.10 이상
  • uv

uvx로 실행

THIRDWEB_SECRET_KEY=... \
    uvx thirdweb-mcp

pipx로 설치 및 실행

pipx install thirdweb-mcp

THIRDWEB_SECRET_KEY=... \
    thirdweb-mcp

소스에서 설치

git clone https://github.com/thirdweb-dev/ai.git thirdweb-ai
cd thirdweb-ai/python/thirdweb-mcp
uv sync

구성

thirdweb MCP 서버는 활성화하려는 서비스에 따라 구성이 필요합니다:

  1. thirdweb 비밀 키: Nebula, Insight, Storage, EngineCloud 서비스에 필요합니다. thirdweb 대시보드에서 획득하세요.
  2. 체인 ID: 연결할 블록체인 네트워크 ID입니다 (예: 이더리움 메인넷은 1, 폴리곤은 137).
  3. Engine 구성: Engine 서비스를 사용하는 경우 Engine URL과 인증 JWT가 필요합니다.
  4. EngineCloud 구성: EngineCloud 작업의 경우 서버 지갑 작업을 위한 Vault 액세스 토큰이 필요할 수 있습니다.

이러한 값들은 명령줄 옵션이나 환경 변수를 통해 제공할 수 있습니다.

사용법

명령줄 옵션

# Basic usage with default settings (stdio transport with Nebula and Insight)
THIRDWEB_SECRET_KEY=... thirdweb-mcp 

# Using SSE transport on a custom port
THIRDWEB_SECRET_KEY=... thirdweb-mcp --transport sse --port 8080

# Enabling all services with specific chain IDs
THIRDWEB_SECRET_KEY=... thirdweb-mcp --chain-id 1 --chain-id 137 \
    --engine-url YOUR_ENGINE_URL \
    --engine-auth-jwt YOUR_ENGINE_JWT \ 
    --engine-backend-wallet-address YOUR_ENGINE_BACKEND_WALLET_ADDRESS \
    --vault-access-token YOUR_VAULT_ACCESS_TOKEN

환경 변수

환경 변수를 사용하여 MCP 서버를 구성할 수도 있습니다:

  • THIRDWEB_SECRET_KEY: thirdweb API 비밀 키
  • THIRDWEB_ENGINE_URL: thirdweb Engine 서비스의 URL 엔드포인트
  • THIRDWEB_ENGINE_AUTH_JWT: Engine용 인증 JWT 토큰
  • THIRDWEB_ENGINE_BACKEND_WALLET_ADDRESS: Engine 백엔드용 지갑 주소
  • THIRDWEB_VAULT_ACCESS_TOKEN: EngineCloud 서버 지갑 작업용 Vault 액세스 토큰

Claude Desktop과의 통합

이 MCP 서버를 Claude Desktop에 추가하려면:

  1. MCP 설치: pipx install thirdweb-mcp

  2. 다음 위치에 Claude Desktop 구성 파일을 생성하거나 편집합니다:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json

  3. 다음 구성을 추가합니다:

    {
  "mcpServers": {
    "thirdweb-mcp": {
      "command": "thirdweb-mcp",
      "args": [], // add `--chain-id` optionally
      "env": {
        "THIRDWEB_SECRET_KEY": "your thirdweb secret key from dashboard",
        "THIRDWEB_ENGINE_URL": "(OPTIONAL) your engine url",
        "THIRDWEB_ENGINE_AUTH_JWT": "(OPTIONAL) your engine auth jwt",
        "THIRDWEB_ENGINE_BACKEND_WALLET_ADDRESS": "(OPTIONAL) your engine backend wallet address",
        "THIRDWEB_VAULT_ACCESS_TOKEN": "(OPTIONAL) your vault access token for EngineCloud"
      },
    }
  }
}

  4. 변경 사항을 적용하려면 Claude Desktop을 다시 시작합니다.

자세한 내용은 MCP 빠른 시작에서 확인하세요.

MCP 클라이언트와의 통합

이 서버는 모델 컨텍스트 프로토콜을 지원하는 모든 클라이언트와 통합할 수 있습니다:

  1. 적절한 구성으로 MCP 서버를 실행합니다.
  2. 선택한 전송 방식(stdio 또는 SSE)을 사용하여 MCP 클라이언트를 서버에 연결합니다.
  3. 노출된 MCP 도구를 통해 thirdweb 서비스에 접근합니다.

사용 가능한 서비스

Nebula

자율적 온체인 실행 및 분석:

  • 스마트 컨트랙트 코드 분석
  • 컨트랙트 상호작용 및 배포
  • 자율적 온체인 작업 실행

Insight

블록체인 데이터 분석 기능 제공:

  • 여러 네트워크에서 온체인 데이터 쿼리
  • 트랜잭션, 블록 및 스마트 컨트랙트 이벤트 분석
  • 지갑 활동 및 토큰 이동 모니터링

Engine

thirdweb 백엔드 인프라와 통합:

  • 스마트 컨트랙트 배포
  • 배포된 컨트랙트와 상호작용
  • 지갑 연결 및 트랜잭션 관리

EngineCloud

고급 기능을 갖춘 클라우드 기반 엔진 작업:

  • KMS 통합으로 서버 지갑 생성 및 관리
  • 스마트 컨트랙트 읽기 및 쓰기
  • 트랜잭션 전송 및 트랜잭션 내역 쿼리
  • 다양한 체인에서 네이티브 토큰 잔액 확인

Storage

탈중앙화 스토리지 기능 제공:

  • 파일, 디렉터리 및 JSON 데이터를 IPFS에 업로드
  • thirdweb 게이트웨이를 사용하여 IPFS에서 콘텐츠 조회
  • 업로드 시 디렉터리 구조 유지

라이선스

Apache-2.0 라이선스

지원

문의 사항이나 지원이 필요하시면 [email protected]으로 연락하거나 thirdweb.com을 방문하세요.