thirdweb MCP Server

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-m
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访问令牌来进行服务器钱包操作。

这些可以通过命令行选项或环境变量提供。

使用

命令行选项

# 使用默认设置的基本用法（stdio传输，带有Nebula和Insight）
THIRDWEB_SECRET_KEY=... thirdweb-mcp 

# 在自定义端口上使用SSE传输
THIRDWEB_SECRET_KEY=... thirdweb-mcp --transport sse --port 8080

# 启用特定链ID的所有服务
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": [], // 可选添加 `--chain-id`
         "env": {
           "THIRDWEB_SECRET_KEY": "您的thirdweb密钥来自仪表板",
           "THIRDWEB_ENGINE_URL": "(可选)您的engine URL",
           "THIRDWEB_ENGINE_AUTH_JWT": "(可选)您的engine认证JWT",
           "THIRDWEB_ENGINE_BACKEND_WALLET_ADDRESS": "(可选)您的engine后端钱包地址",
           "THIRDWEB_VAULT_ACCESS_TOKEN": "(可选)您的Vault访问令牌用于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。