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='',
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.
许可证
麻省理工学院