O que mupen64mcp-agent-skill faz?
Habilidade de agente Cursor para depuração em tempo de execução N64 com Mupen64MCP (Mupen64Plus MCP, 38 ferramentas)
Visão Geral
Esta habilidade integra o Mupen64Plus com o Cursor através do protocolo MCP, fornecendo 38 ferramentas para controle e depuração completa do emulador N64.
Pré-requisitos
- Cursor com suporte a agentes MCP
- Mupen64Plus instalado e configurado
- Mupen64MCP Server rodando localmente
Funcionalidades Principais
Controle do Emulador
- Iniciar/parar emulação
- Carregar ROMs
- Gerenciar estados de save (salvar/carregar)
- Controlar velocidade de emulação
Depuração Avançada
- Inspecionar e modificar memória N64
- Definir breakpoints em endereços de memória
- Execução passo a passo (step into, step over)
- Visualizar e editar registradores
- Monitorar chamadas de função
Análise em Tempo Real
- Capturar screenshots
- Extrair texturas
- Log de instruções executadas
- Análise de performance
Configuração
- Instale o Mupen64Plus:
brew install mupen64plus # macOS
sudo apt install mupen64plus # Linux
- Baixe e execute o servidor Mupen64MCP:
git clone https://github.com/DohmBoy64Bit/mupen64mcp.git
cd mupen64mcp
python server.py
- No Cursor, configure o agente para usar este skill.
Exemplo de Uso
# Exemplo: carregar ROM e executar até breakpoint
await agent.call('load_rom', {'path': '/roms/zelda_oot.z64'})
await agent.call('set_breakpoint', {'address': 0x8002A5C0})
await agent.call('run')
Ferramentas Disponíveis
| Ferramenta | Descrição |
|---|---|
load_rom | Carrega uma ROM N64 |
set_breakpoint | Define um breakpoint |
read_memory | Lê região de memória |
write_memory | Escreve em região de memória |
| ... (38 ferramentas no total) | ... |
Notas Importantes
- Requer ROMs legais (próprias ou de domínio público)
- O servidor MCP deve estar rodando antes de usar o agente
- Compatível com Cursor (versão 0.45+) e agentes que suportam MCP