Sensei MCP

Sensei MCP

O Sensei MCP é um servidor de Model Context Protocol (MCP) que fornece orientação especializada para desenvolvimento com Dojo e Cairo na Starknet. Ele atua como seu Sensei pessoal de Dojo, oferecendo conhecimento especializado e assistência para construir mundos onchain usando o framework Dojo Entity Component System (ECS).

Recursos

• Orientação especializada em Cairo: Obtenha ajuda com os sistemas exclusivos de ownership, memória e tipos do Cairo
• Arquitetura Dojo ECS: Aprenda sobre padrões de Models, Systems e World
• Desenvolvimento de Smart Contracts: Melhores práticas para smart contracts na Starknet
• Ferramentas especializadas: Acesse ferramentas específicas para models, systems, testes e muito mais

Usando com o Cursor

Instalação

Consulte a documentação oficial do Cursor para mais informações sobre como instalar e usar servidores MCP.

Para adicionar o Sensei ao seu IDE Cursor:

1. Abra a paleta de comandos do Cursor (⌘+Shift+P)
2. Digite "Cursor Settings" para abrir o menu de configurações
3. Navegue até "MCP Tools" e clique em "New MCP Server"
4. Adicione a seguinte configuração ao mcp.json:

{
  "mcpServers": {
    "sensei": {
      "type": "command",
      "command": "npx github:dojoengine/sensei-mcp",
      "enabled": true
    }
  }
}

5. Salve o arquivo

O Cursor tentará inicializar o servidor. Uma vez inicializado, o menu deve ficar assim:

Observação: talvez seja necessário instalar o servidor manualmente executando npx github:dojoengine/sensei-mcp no seu terminal antes que o Cursor o reconheça.

Uso

Após a instalação, o Cursor Agent consultará automaticamente o Sensei quando apropriado. Siga estas melhores práticas para obter resultados ideais:

1. Sempre mencione as ferramentas especializadas: Peça explicitamente ao agente para usar as ferramentas especializadas do Sensei (por exemplo, "Por favor, use a ferramenta dojo_model para me ajudar a criar um model").

2. Siga a abordagem de desenvolvimento incremental:

   • Comece com a configuração do projeto usando dojo_101
   • Defina os models primeiro usando dojo_model
   • Implemente os systems em seguida usando dojo_logic
   • Configure o projeto por último usando dojo_config
   • Adicione testes usando dojo_test

3. Seja específico nas suas solicitações: Por exemplo, em vez de pedir "Me ajude com meu jogo Dojo", diga "Por favor, use a ferramenta dojo_model para me ajudar a criar um model Position para o meu jogo."

4. Divida tarefas complexas: Peça ajuda com um componente por vez, em vez de solicitar a implementação de um jogo inteiro de uma só vez.

Exemplo de prompt:

I'm building a Dojo game. First, please use the dojo_101 tool to help me set up the project structure.
After that, I'll need help creating the models using the dojo_model tool.

Usando com o Claude Code

Para adicionar o Sensei MCP ao Claude Code, execute o seguinte comando:

claude mcp add sensei-mcp npx github:dojoengine/sensei-mcp

Executando Diretamente

Você também pode executar o Sensei MCP diretamente no terminal:

npx github:dojoengine/sensei-mcp

Ferramentas Disponíveis

O Sensei fornece ferramentas especializadas para diferentes aspectos do desenvolvimento com Dojo:

• dojo_101: Introdução amigável para iniciantes no desenvolvimento com Dojo
• dojo_config: Orientação essencial para configurar projetos Dojo
• dojo_logic: Orientação especializada na implementação de systems Dojo e lógica de jogo
• dojo_model: Orientação especializada para criar e trabalhar com models Dojo
• dojo_test: Guia abrangente para escrever testes para aplicações Dojo
• dojo_token: Orientação detalhada sobre a implementação de padrões de tokens no Dojo

Como Usar as Ferramentas

Ao conversar com o Sensei, você pode solicitar orientação específica mencionando o nome da ferramenta:

Can you help me understand how to create a model in Dojo?

O Sensei usará automaticamente a ferramenta apropriada (neste caso, dojo_model) para fornecer orientação especializada.

Fluxo de Desenvolvimento Recomendado

Para obter os melhores resultados, siga esta abordagem de desenvolvimento incremental:

1. Configuração do Projeto (use dojo_101)

   • Inicialize seu projeto com sozo init
   • Entenda a estrutura do projeto
   • Remova ou substitua o código boilerplate

2. Defina os Models (use dojo_model)

   • Crie os models do estado do seu jogo
   • Garanta a derivação adequada de traits
   • Configure os campos-chave corretamente

3. Implemente os Systems (use dojo_logic)

   • Crie os contracts dos systems
   • Implemente as mecânicas do jogo
   • Gerencie as mudanças de estado

4. Configuração do Projeto (use dojo_config)

   • Configure o Scarb.toml
   • Configure os perfis do Dojo
   • Gerencie as dependências

5. Testes (use dojo_test)

   • Escreva testes abrangentes
   • Verifique a lógica do jogo

Este fluxo garante que você construa sua aplicação Dojo de forma estruturada e metódica, aproveitando o conhecimento especializado de cada ferramenta na etapa apropriada do desenvolvimento.

Especialização Principal

O Sensei possui profundo conhecimento em:

• Linguagem de programação Cairo (incluindo seus sistemas exclusivos de ownership, memória e tipos)
• Arquitetura Dojo ECS (Models, Systems e World)
• Desenvolvimento de smart contracts na Starknet
• Melhores práticas para desenvolvimento de jogos onchain

Desenvolvimento

Estrutura do Projeto

• bin/: Contém o script executável
• src/: Código-fonte do servidor MCP
• prompts/: Prompts de texto para diferentes aspectos do desenvolvimento com Dojo
• resources/: Recursos adicionais usados pelos prompts

Compilando a partir do Código-Fonte

# Clone the repository
git clone https://github.com/dojoengine/sensei-mcp.git
cd sensei-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start