Thirdweb

官方

讀寫超過2000條區塊鏈，支援資料查詢、合約分析/部署及交易執行，由Thirdweb提供技術支援。

GitHub
19

你可以用 Thirdweb MCP 做什麼？

  • 分析鏈上數據 — 要求 Insight 查詢支援網路上的交易、區塊、合約事件或錢包活動。
  • 部署並與合約互動 — 使用 Engine 部署智慧合約，並透過後端基礎設施對其進行讀取與寫入。
  • 管理伺服器錢包 — 使用 EngineCloud 建立由 KMS 支援的伺服器錢包、發送交易，並檢查原生代幣餘額。
  • 上傳檔案與 JSON 至 IPFS — 將檔案、目錄或 JSON 資料儲存至 IPFS，並透過 thirdweb 閘道器進行擷取。

文件

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 代表 Polygon）。
  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 授權

支援

如有疑問或需要支援，請聯絡 support@thirdweb.com 或造訪 thirdweb.com。