智能合约转换工具

将ARC-56智能合约转换为MCP服务器,便于AI代理集成,提供安全的环境配置和多种调用类型过滤。

  • by aorumbayev
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 aorumbayev/arcontextify

使用说明


将ARC-56智能合约转换为MCP服务器,以实现AI代理集成。

免责声明:这是一个实验性的概念验证工具。它不是用于生产用途的,可能包含错误或不完整的功能。

特性

  • 🔄 将ARC-56规范转换为MCP服务器
  • 🛡️ 基于环境的安全配置
  • 🎯 调用类型筛选(只读/只写/两者都有)
  • 🧪 安全测试模拟模式
  • ⚡ AlgoKit Utils集成
  • 📦 基于UV的项目生成

安装

pipx install arcontextify 
# or
uv tool install arcontextify

用法

# Generate MCP server
arcontextify contract.arc56.json

# Readonly calls only (no private key needed)
arcontextify contract.arc56.json --call-types readonly

# Write calls only 
arcontextify contract.arc56.json --call-types write-only

# Custom output directory
arcontextify contract.arc56.json --output-dir ./servers

生成的服务器

每台服务器包括:

环境变量

export ALGORAND_ALGOD_TOKEN="your-token"
export ALGORAND_ALGOD_SERVER="https://testnet-api.algonode.cloud"  
export ALGORAND_APP_ID="123456"
export ALGORAND_DELEGATED_PRIVATE_KEY="your-key"  # Not needed for readonly

Claude桌面配置

{
  "mcpServers": {
    "contract_mcp": {
      "command": "uv",
      "args": ["run", "python", "-m", "src.contract_mcp"],
      "cwd": "/path/to/contract_mcp",
      "env": {
        "ALGORAND_ALGOD_TOKEN": "your-token",
        "ALGORAND_ALGOD_SERVER": "https://testnet-api.algonode.cloud",
        "ALGORAND_APP_ID": "123456"
      }
    }
  }
}

可用工具

  • verify_environment_setup() -检查配置
  • get_connection_info() -连接状态
  • get_application_state() -全球状态
  • get_account_local_state(address) -地方州
  • 具有模拟支持的合同方法

安全

  • 基于环境的秘密(没有硬编码密钥)
  • 只读操作的虚拟帐户
  • 用于安全测试的事务模拟
  • 地址验证和输入净化

需求

  • Python 3.10+
  • UV包管理器
  • AlgoKit实用工具2.0+

许可证

麻省理工学院