Ebitengine MCP

Um servidor para jogos Ebitengine que fornece ferramentas de depuração e gravação ao capturar o estado do jogo.

Documentação

Servidor MCP para Ebitengine

Baixe este pacote.

go get github.com/sedyh/ebitengine-mcp@v1.1.0

Envolva seu jogo para registrar seu estado.

examples/plain-record/main.go

import "github.com/sedyh/ebitengine-mcp/mcp"

func main() {
  if err := ebiten.RunGame(mcp.Wrap(NewGame())); err != nil {
    log.Fatal(err)
  }
}

E adicione esta configuração aos seus servidores mcp.

~/.cursor/mcp.json

{
  "mcpServers": {
    "ebitengine-mcp": {
      "command": "go run github.com/sedyh/ebitengine-mcp/cmd/server@v1.1.0"
    }
  }
}
Outros editores
VS Code
~/.vscode/mcp.json


    {
      "servers": {
        "ebitengine-mcp": {
          "type": "stdio",
          "command": "go",
          "args": ["run", "github.com/sedyh/ebitengine-mcp/cmd/server@v1.1.0"]
        }
      }
    }
    
Windsurf
~/.codeium/windsurf/mcp_config.json


    {
      "mcpServers": {
        "ebitengine-mcp": {
          "command": "go",
          "args": ["run", "github.com/sedyh/ebitengine-mcp/cmd/server@v1.1.0"]
        }
      }
    }
    

Peça ao seu agente para depurar algo no seu jogo, você pode usar example/record como exemplo.

Ferramentas disponíveis

Todas

  • Capturar logs de build e lançamento.
  • Capturar erros do aplicativo.

Gravar

  • Capturar N quadros com atraso M em milissegundos.

Casos especiais

  • DrawFinalScreen
  • LayoutF

Plugins e editores suportados

Matriz de suporte de recursos: verifique a guia de ferramentas.

  • Cursor
  • Windsurf
  • VS Code
  • Claude Code
  • Claude Desktop
  • Cline
  • Emacs MCP
  • Neovim MCP
  • Continue
  • OpenSumi
  • TheiaAI
  • Roo Code
  • Zed
  • Trae

Arquitetura

Seu editor baseado em LLM executa um servidor mcp stdio que fornece várias ferramentas para trabalhar com o jogo no seu projeto. O editor especifica as configurações e o local para executar o projeto, e o servidor as monta e passa certas flags na inicialização, que são captadas pelo decorador embutido no jogo. O decorador escuta solicitações para executar ferramentas, executa-as e retorna uma resposta via conexão reversa ao servidor, após o que fecha. O servidor complementa a resposta com logs do aplicativo e adapta a resposta ao contexto mcp. O servidor permanece em execução enquanto o editor quiser.

Comandos

test-server, test-client

Verificando a operação de uma mensagem via conexão reversa baseada em long polling.

test-cli, test-bin

Testando um builder universal que pode executar o projeto de qualquer lugar fora do diretório de trabalho.

server, client

Testando o trabalho via mcp junto com toda a cadeia de processamento de mensagens.