Arcontextify

---

Converta contratos inteligentes ARC-56 em servidores MCP para integração com agentes de IA.

Aviso: esta é uma ferramenta experimental de prova de conceito. Não é destinada ao uso em produção e pode conter bugs ou recursos incompletos.

Recursos

• 🔄 Converte especificações ARC-56 em servidores MCP
• 🛡️ Configuração segura baseada em ambiente
• 🎯 Filtragem por tipo de chamada (somente leitura/somente escrita/ambos)
• 🧪 Modo de simulação para testes seguros
• ⚡ Integração com AlgoKit Utils
• 📦 Geração de projetos baseada em UV

Instalação

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 Gerado

Cada servidor inclui:

Variáveis de Ambiente

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

Configuração do 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"
      }
    }
  }
}

Ferramentas Disponíveis

• verify_environment_setup() - Verificar configuração
• get_connection_info() - Status da conexão
• get_application_state() - Estado global
• get_account_local_state(address) - Estado local
• Métodos de contrato com suporte a simulação

Segurança

• Segredos baseados em ambiente (sem chaves codificadas)
• Contas fictícias para operações somente leitura
• Simulação de transações para testes seguros
• Validação de endereços e sanitização de entrada

Requisitos

• Python 3.10+
• Gerenciador de pacotes UV
• AlgoKit Utils 2.0+

Licença

MIT