上下文化工具

【技术文档摘要】：

<div align="center"> <a href="https://ibb.co/39mShM2H"><img src="https://gips3.baidu.com/it/u=3124677902,3853162912&fm=3081&app=3081&f=PNG?w=640&h=214" alt="Qm-Zqt55w-HXr-Zzh-Bih-SVz-XDvwp9rguv-LAv-Fh-Um1q-JR6-GYe-Q" border="0" width="60%"></a> </div>

---

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

免责声明：这是一个实验性的概念验证工具。它不适用于生产环境，并可能包含错误或不完整的功能。

功能

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

安装

pipx install arcontextify 
# 或
uv tool install arcontextify

使用方法

# 生成MCP服务器
arcontextify contract.arc56.json

# 只读调用（不需要私钥）
arcontextify contract.arc56.json --call-types readonly

# 只写调用
arcontextify contract.arc56.json --call-types write-only

# 自定义输出目录
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"  # 只读时不需要

Claude Desktop 配置

{
  "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 Utils 2.0+

许可证

MIT