Extensões

Extensões são pacotes NuGet opcionais que ensinam ao Godot MCP mais partes do Godot e addons populares do Godot. Instale apenas as que o seu projeto precisa. Esta página as lista, explica como funcionam e mostra as três formas de instalar uma. Descrições e exemplos de cada extensão estão na página extensões do Godot do site.

Como as extensões funcionam#

Cada extensão é um módulo RQL. Ela não adiciona ferramentas MCP próprias. Em vez disso, estende as ferramentas centrais rql-query, rql-mutate e rql-schema com novas fontes, propriedades validadas e chamadas, e adiciona um guia à skill godot-rql do agente. A lista de ferramentas do seu agente continua do mesmo tamanho, e o agente aprende a nova área por meio de rql-schema:

rql-schema "Particles"

Os pacotes contêm código-fonte C# e configurações de build, compilados com o GodotSharp do próprio projeto. Cada extensão tem sua própria versão e lançamento.

Extensões disponíveis#

Toda extensão também precisa de um addon central que tenha as ferramentas RQL (qualquer versão após a 0.28.0).

Instalar com godot-cli#

godot-cli install-extension com.IvanMurzak.Godot.MCP.CSG ./MyGodotProject
godot-cli build ./MyGodotProject

install-extension procura o id no catálogo de extensões, primeiro pelo id do pacote e depois pelo nome, sem diferenciar maiúsculas de minúsculas (então "CSG Tools" também funciona). Em seguida, adiciona ou atualiza um <PackageReference> no .csproj do seu projeto:

• ainda não referenciado: a referência é adicionada;
• uma versão mais antiga está referenciada: ela é atualizada;
• já atualizado: nada muda.

Sem --version, a referência flutua para a versão estável mais recente no NuGet (Version="*"). Use --version <x.y.z> para solicitar uma versão exata. Depois de instalar, compile o projeto para que o Godot restaure e compile o pacote; o Godot não tem etapa de restauração automática.

Instalar pelo dock#

A seção Extensions do dock do AI Game Developer lista o mesmo catálogo com botões Install e Update. Ela edita o .csproj da mesma forma que a CLI. Recompile depois. Se o dock informar que nenhum .csproj foi encontrado, o addon não está dentro de um projeto C# do Godot.

Instalar pelo app AI Game Dev#

Para projetos Godot, o app AI Game Dev mostra um botão Extensions na barra lateral que abre o mesmo catálogo e instala usando o mesmo código do godot-cli. Seu comando de barra /install-extension faz o mesmo a partir do chat do app: sem argumentos, lista o catálogo; com um id, instala no projeto atual. As extensões de engine não são iguais aos pacotes do próprio app.

O catálogo de extensões#

A lista de extensões fica em addons/godot_mcp/extensions.catalog.json, enviada junto com o addon. O dock, o godot-cli e o app leem todos esse mesmo arquivo. O dock a lê do seu projeto compilado, e é por isso que o seu .csproj precisa incorporá-la:

<ItemGroup>
  <EmbeddedResource Include="addons/godot_mcp/extensions.catalog.json" LogicalName="Godot-MCP.extensions.catalog.json" />
</ItemGroup>

godot-cli install-plugin e o app adicionam essa linha para você. Se você instalou manualmente e a lista de Extensions está vazia, essa linha está faltando; adicione-a e recompile. Veja Instalação.

Usando uma extensão#

Depois da compilação, é só pedir. Por exemplo, com o CSG Tools instalado:

• "Crie um combinador CSG com uma caixa 3x3x3 e subtraia dela uma esfera de raio 1.8."
• "Liste todas as formas CSG da cena com sua operação e tamanho."

O agente cria os nós com rql-mutate (um passo desfazível por chamada) e verifica o resultado com rql-query. Valores inválidos, como um raio negativo, fazem a alteração inteira falhar e deixam a cena intacta.

Escreva sua própria extensão#

O repositório Godot-MCP contém um template de extensão (templates/extension/) e um guia de monorepo para compilar, testar e lançar módulos. Para ferramentas pontuais de um projeto, as ferramentas personalizadas padrão são mais simples.