Thirdweb MCP Server

Server MCP thirdweb

Implementasi server Model Context Protocol (MCP) untuk integrasi layanan thirdweb. Server ini memungkinkan Anda mengintegrasikan alat-alat thirdweb dengan klien apa pun yang kompatibel dengan MCP.

Gambaran Umum

MCP thirdweb menyediakan antarmuka terpadu untuk mengakses rangkaian alat dan layanan blockchain thirdweb melalui Model Context Protocol yang terstandarisasi. Server ini mendukung berbagai transport komunikasi dan dapat diintegrasikan dengan berbagai layanan thirdweb:

• Nebula: Eksekusi onchain otonom - analisis on-chain real-time, pembuatan kode, dan interaksi kontrak
• Insight: Kemampuan analisis data blockchain untuk data on-chain real-time
• Engine: Integrasi dengan infrastruktur backend thirdweb untuk deployment dan interaksi kontrak
• EngineCloud: Operasi engine berbasis cloud untuk dompet server, interaksi kontrak, dan manajemen transaksi
• Storage: Kemampuan penyimpanan terdesentralisasi untuk mengunggah dan mengambil data melalui IPFS

Instalasi

Prasyarat

• Python 3.10 atau lebih tinggi
• uv

Jalankan dengan uvx

THIRDWEB_SECRET_KEY=... \
    uvx thirdweb-mcp

Instal dan jalankan dengan pipx

pipx install thirdweb-mcp

THIRDWEB_SECRET_KEY=... \
    thirdweb-mcp

Instal dari sumber

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

Konfigurasi

Server MCP thirdweb memerlukan konfigurasi berdasarkan layanan mana yang ingin Anda aktifkan:

1. Kunci Rahasia thirdweb: Diperlukan untuk layanan Nebula, Insight, Storage, dan EngineCloud. Dapatkan dari dasbor thirdweb.
2. ID Rantai: ID jaringan blockchain yang akan dihubungkan (mis., 1 untuk Ethereum mainnet, 137 untuk Polygon).
3. Konfigurasi Engine: Jika menggunakan layanan Engine, Anda memerlukan URL Engine dan JWT autentikasi.
4. Konfigurasi EngineCloud: Untuk operasi EngineCloud, Anda mungkin memerlukan Token Akses Vault untuk operasi dompet server.

Anda dapat menyediakannya melalui opsi baris perintah atau variabel lingkungan.

Penggunaan

Opsi baris perintah

# 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

Variabel lingkungan

Anda juga dapat mengonfigurasi server MCP menggunakan variabel lingkungan:

• THIRDWEB_SECRET_KEY: Kunci rahasia API thirdweb Anda
• THIRDWEB_ENGINE_URL: Endpoint URL untuk layanan thirdweb Engine
• THIRDWEB_ENGINE_AUTH_JWT: Token JWT autentikasi untuk Engine
• THIRDWEB_ENGINE_BACKEND_WALLET_ADDRESS: Alamat dompet untuk backend Engine
• THIRDWEB_VAULT_ACCESS_TOKEN: Token akses Vault untuk operasi dompet server EngineCloud

Integrasi dengan Claude Desktop

Untuk menambahkan server MCP ini ke Claude Desktop:

1. Instal MCP: pipx install thirdweb-mcp

2. Buat atau edit file konfigurasi Claude Desktop di:

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

3. Tambahkan konfigurasi berikut:

   {
     "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. Mulai ulang Claude Desktop agar perubahan diterapkan.

Baca selengkapnya di Panduan Memulai Cepat MCP

Integrasi dengan klien MCP

Server ini dapat diintegrasikan dengan klien apa pun yang mendukung Model Context Protocol:

1. Jalankan server MCP dengan konfigurasi yang sesuai
2. Hubungkan klien MCP Anda ke server menggunakan transport yang dipilih (stdio atau SSE)
3. Akses layanan thirdweb melalui alat MCP yang tersedia

Layanan yang Tersedia

Nebula

Eksekusi dan analisis onchain otonom:

• Menganalisis kode kontrak pintar
• Interaksi dan deployment kontrak
• Eksekusi tugas onchain otonom

Insight

Menawarkan kemampuan analisis data blockchain:

• Kueri data on-chain di berbagai jaringan
• Menganalisis transaksi, blok, dan peristiwa kontrak pintar
• Memantau aktivitas dompet dan pergerakan token

Engine

Terintegrasi dengan infrastruktur backend thirdweb:

• Men-deploy kontrak pintar
• Berinteraksi dengan kontrak yang sudah di-deploy
• Mengelola koneksi dompet dan transaksi

EngineCloud

Operasi engine berbasis cloud dengan kemampuan lanjutan:

• Membuat dan mengelola dompet server dengan integrasi KMS
• Membaca dari dan menulis ke kontrak pintar
• Mengirim transaksi dan mengkueri riwayat transaksi
• Memeriksa saldo token asli di berbagai rantai

Storage

Menyediakan fungsionalitas penyimpanan terdesentralisasi:

• Mengunggah file, direktori, dan data JSON ke IPFS
• Mengambil konten dari IPFS menggunakan gateway thirdweb
• Mempertahankan struktur direktori saat mengunggah

Lisensi

Lisensi Apache-2.0

Dukungan

Untuk pertanyaan atau dukungan, silakan hubungi [email protected] atau kunjungi thirdweb.com.