AI导哈

Tezos区块链交互工具

Tezos MCP是一个用于Tezos区块链的模型上下文协议服务器，支持通过标准MCP工具与Tezos原生交互，包括查询余额、合约存储、交易历史等读操作，以及发送交易、部署合约等写操作。

  • by efekucuk
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 efekucuk/tezos-mcp

使用说明

Tezos MCPꜩ

tezos区块链的模型上下文协议服务器。让claude通过标准mcp工具与tezos进行本地交互。

它的作用

读取操作 （无需钥匙）

  • 查询余额、合同存储、交易历史
  • 获取块信息和网络常数
  • 跨主网、shadownet、ghostnet工作

写入操作 （需要私钥）

  • 发送交易并部署合约
  • 呼叫合同入口点
  • 对消息进行签名/验证，生成地址

支持的网络

  • 主网-生产
  • shadowen-主测试网（推荐）
  • ghostnet-遗留测试网（已弃用，迁移到shadowown）

设置

快速启动（只读）

无需pytezos编译即可立即工作：

python -m venv .venv
source .venv/bin/activate  # windows: .venv\Scripts\activate
pip install "mcp>=1.0.0" "httpx>=0.27.0"

# register with claude
claude mcp add --transport stdio tezos-readonly -- python server_readonly.py

完整设置（包括交易）

写操作需要pytezos。在windows上，使用conda最简单：

conda create -n tezos-mcp python=3.11
conda activate tezos-mcp
pip install "mcp>=1.0.0" "httpx>=0.27.0"
conda install -c conda-forge pytezos

claude mcp add --transport stdio tezos -- python server.py

看见 INSTALL_WINDOWS.md 如果conda不可用，则使用wsl2/docker选项。

用法

claude

那么：

> /mcp                                    # verify server connected
> what's the balance of tz1VSUr8... ?    # query balance
> show recent ops for tz1...             # transaction history
> latest block on shadownet               # block info

对于事务（需要TEZOS_PRIVATE_KEY环境变量）：

> send 1 xtz to tz1... on shadownet
> deploy this contract to shadownet
> call mint on contract KT1...

运用技能

> /tezos help me build an fa2 token
> /tezos optimize gas in this contract
> /tezos security checklist

配置

环境变量

# private key for transactions
export TEZOS_PRIVATE_KEY="edsk..."

# optional: custom rpc nodes
export TEZOS_MAINNET_NODE="https://your-node.com"
export TEZOS_SHADOWNET_NODE="https://your-node.com"

或使用 .env 文件（参见 .env.example).

默认端点

验证自 teztnets.com 官方文件：

  • 主网： https://mainnet.api.tez.ie
  • 阴影： https://rpc.shadownet.teztnets.com
  • 幽灵网： https://rpc.ghostnet.teztnets.com

可用工具

阅读工具

工具 参数 示例
get_balance 地址，网络 主网tz1…的余额
get_contract_storage 合约地址，网络 KT1的存储
get_operations 地址、限制、网络 tz1的最后10次操作
get_block_info 级别（可选），网络 最新块信息
get_network_info 网络 网络常数

书写工具

工具 参数 注释
send_transaction 目的地，amount_mutez，网络 需要私钥
call_connect 合约，入口点，参数，金额 执行合约
原始合同 代码、存储、网络 部署新合同
sign_message message 加密签名
verify_signature 消息、签名、公钥 验证已签名的消息
generate_address 助记符（可选） 创建新地址

示例

查询余额

get_balance(
    address="tz1VSUr8wwNhLAzempoch5d6hLRiTh8Cjcjb",
    network="mainnet"
)

发送交易

send_transaction(
    destination="tz1...",
    amount_mutez=1_000_000,  # 1 xtz
    network="shadownet"
)

部署合约

originate_contract(
    code='<michelson_code>',
    storage='42',
    network="shadownet"
)

看见 examples.md 更多图案。

项目结构

tezos-mcp/
├── server.py              # full mcp server (13 tools)
├── server_readonly.py     # read-only version (4 tools)
├── pyproject.toml         # dependencies
├── README.md              # this file
├── QUICKSTART.md          # 5min setup guide
├── SOURCES.md             # verified endpoints & docs
├── examples.md            # usage patterns
├── INSTALL_WINDOWS.md     # windows installation
├── .env.example           # config template
└── .claude/
    └── skills/
        └── tezos/
            └── SKILL.md   # development guidance

安全

  • 从不提交私钥
  • 使用shadowent进行测试
  • 主网部署前审计合同
  • 为键使用环境变量
  • 所有端点均已根据官方来源进行验证

看见 SOURCES.md 用于文件验证。

资源

使用的官方文件：

贡献

此实现仅引用官方tezos文档。所有rpc端点和网络配置都经过验证 teztnets.com 和 docs.tezos.com.

许可证

麻省理工学院

相关 MCP