Thirdweb MCP Server

官方

通过Thirdweb，可对超过2000条区块链进行读写操作，支持数据查询、合约分析/部署及交易执行。

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 代表 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 许可证

支持

如有问题或需要支持，请联系 [email protected] 或访问 thirdweb.com。