Arcontextify

---

Convierte contratos inteligentes ARC-56 a servidores MCP para integración con agentes de IA.

Aviso: esta es una herramienta experimental de prueba de concepto. No está destinada para uso en producción y puede contener errores o características incompletas.

Características

• 🔄 Convierte especificaciones ARC-56 a servidores MCP
• 🛡️ Configuración segura basada en variables de entorno
• 🎯 Filtrado de tipos de llamada (solo lectura/solo escritura/ambos)
• 🧪 Modo de simulación para pruebas seguras
• ⚡ Integración con AlgoKit Utils
• 📦 Generación de proyectos basada en UV

Instalación

pipx install arcontextify 
# or
uv tool install arcontextify

Uso

# 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

Servidor Generado

Cada servidor incluye:

Variables de Entorno

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

Configuración de 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"
      }
    }
  }
}

Herramientas Disponibles

• verify_environment_setup() - Verificar configuración
• get_connection_info() - Estado de conexión
• get_application_state() - Estado global
• get_account_local_state(address) - Estado local
• Métodos de contrato con soporte de simulación

Seguridad

• Secretos basados en variables de entorno (sin claves codificadas)
• Cuentas ficticias para operaciones de solo lectura
• Simulación de transacciones para pruebas seguras
• Validación de direcciones y saneamiento de entradas

Requisitos

• Python 3.10+
• Gestor de paquetes UV
• AlgoKit Utils 2.0+

Licencia

MIT