Thirdweb MCP Server

chính thức

Đọc/ghi trên hơn 2.000 blockchain, cho phép truy vấn dữ liệu, phân tích/triển khai hợp đồng và thực thi giao dịch, được hỗ trợ bởi Thirdweb.

GitHub
20

Tài liệu

Máy chủ MCP thirdweb

Một máy chủ triển khai Model Context Protocol (MCP) để tích hợp các dịch vụ của thirdweb. Máy chủ này cho phép bạn tích hợp các công cụ của thirdweb với bất kỳ client tương thích MCP nào.

Tổng quan

MCP thirdweb cung cấp một giao diện thống nhất để truy cập bộ công cụ và dịch vụ blockchain của thirdweb thông qua Model Context Protocol đã được chuẩn hóa. Nó hỗ trợ nhiều phương thức truyền tải giao tiếp và có thể được tích hợp với nhiều dịch vụ khác nhau của thirdweb:

  • Nebula: Thực thi onchain tự động - phân tích on-chain thời gian thực, tạo mã và tương tác với hợp đồng
  • Insight: Khả năng phân tích dữ liệu blockchain cho dữ liệu on-chain thời gian thực
  • Engine: Tích hợp với cơ sở hạ tầng backend của thirdweb để triển khai và tương tác hợp đồng
  • EngineCloud: Các thao tác engine dựa trên đám mây cho ví máy chủ, tương tác hợp đồng và quản lý giao dịch
  • Storage: Khả năng lưu trữ phi tập trung để tải lên và truy xuất dữ liệu qua IPFS

Cài đặt

Yêu cầu tiên quyết

  • Python 3.10 trở lên
  • uv

Chạy với uvx

THIRDWEB_SECRET_KEY=... \
    uvx thirdweb-mcp

Cài đặt và chạy với pipx

pipx install thirdweb-mcp

THIRDWEB_SECRET_KEY=... \
    thirdweb-mcp

Cài đặt từ mã nguồn

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

Cấu hình

Máy chủ MCP thirdweb yêu cầu cấu hình dựa trên những dịch vụ bạn muốn kích hoạt:

  1. Khóa bí mật thirdweb: Cần thiết cho các dịch vụ Nebula, Insight, Storage và EngineCloud. Lấy từ bảng điều khiển thirdweb.
  2. ID chuỗi: ID mạng blockchain để kết nối (ví dụ: 1 cho mạng chính Ethereum, 137 cho Polygon).
  3. Cấu hình Engine: Nếu sử dụng dịch vụ Engine, bạn sẽ cần URL Engine và JWT xác thực.
  4. Cấu hình EngineCloud: Đối với các thao tác EngineCloud, bạn có thể cần Mã thông báo truy cập Vault cho các thao tác ví máy chủ.

Bạn có thể cung cấp các thông tin này thông qua các tùy chọn dòng lệnh hoặc biến môi trường.

Cách sử dụng

Tùy chọn dòng lệnh

# 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

Biến môi trường

Bạn cũng có thể cấu hình máy chủ MCP bằng các biến môi trường:

  • THIRDWEB_SECRET_KEY: Khóa bí mật API thirdweb của bạn
  • THIRDWEB_ENGINE_URL: Điểm cuối URL cho dịch vụ thirdweb Engine
  • THIRDWEB_ENGINE_AUTH_JWT: Mã thông báo JWT xác thực cho Engine
  • THIRDWEB_ENGINE_BACKEND_WALLET_ADDRESS: Địa chỉ ví cho backend Engine
  • THIRDWEB_VAULT_ACCESS_TOKEN: Mã thông báo truy cập vault cho các thao tác ví máy chủ EngineCloud

Tích hợp với Claude Desktop

Để thêm máy chủ MCP này vào Claude Desktop:

  1. Cài đặt MCP: pipx install thirdweb-mcp

  2. Tạo hoặc chỉnh sửa tệp cấu hình Claude Desktop tại:

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

  3. Thêm cấu hình sau:

    {
  "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. Khởi động lại Claude Desktop để các thay đổi có hiệu lực.

Đọc thêm tại MCP Quickstart

Tích hợp với các client MCP

Máy chủ này có thể được tích hợp với bất kỳ client nào hỗ trợ Model Context Protocol:

  1. Chạy máy chủ MCP với cấu hình phù hợp
  2. Kết nối client MCP của bạn với máy chủ bằng phương thức truyền tải đã chọn (stdio hoặc SSE)
  3. Truy cập các dịch vụ thirdweb thông qua các công cụ MCP được hiển thị

Các dịch vụ có sẵn

Nebula

Thực thi và phân tích onchain tự động:

  • Phân tích mã hợp đồng thông minh
  • Tương tác và triển khai hợp đồng
  • Thực thi các tác vụ onchain tự động

Insight

Cung cấp khả năng phân tích dữ liệu blockchain:

  • Truy vấn dữ liệu on-chain trên nhiều mạng
  • Phân tích giao dịch, khối và sự kiện hợp đồng thông minh
  • Giám sát hoạt động ví và chuyển động token

Engine

Tích hợp với cơ sở hạ tầng backend của thirdweb:

  • Triển khai hợp đồng thông minh
  • Tương tác với các hợp đồng đã triển khai
  • Quản lý kết nối ví và giao dịch

EngineCloud

Các thao tác engine dựa trên đám mây với khả năng nâng cao:

  • Tạo và quản lý ví máy chủ với tích hợp KMS
  • Đọc từ và ghi vào hợp đồng thông minh
  • Gửi giao dịch và truy vấn lịch sử giao dịch
  • Kiểm tra số dư token gốc trên các chuỗi khác nhau

Storage

Cung cấp chức năng lưu trữ phi tập trung:

  • Tải lên tệp, thư mục và dữ liệu JSON lên IPFS
  • Truy xuất nội dung từ IPFS bằng cổng thirdweb
  • Bảo toàn cấu trúc thư mục khi tải lên

Giấy phép

Giấy phép Apache-2.0

Hỗ trợ

Nếu có câu hỏi hoặc cần hỗ trợ, vui lòng liên hệ [email protected] hoặc truy cập thirdweb.com.