Sensei MCP

🚀 Sensei MCP

Sensei MCP is a Model Context Protocol (MCP) server that offers expert guidance for Dojo and Cairo development on Starknet. It serves as your personal dojo instructor, providing specialized knowledge and support for building on-chain worlds using the Dojo Entity Component System (ECS) framework.

✨ Features

• Expert Cairo Guidance: Get assistance in dealing with Cairo's unique ownership, memory, and type systems.
• Dojo ECS Architecture: Understand the patterns of models, systems, and worlds.
• Smart Contract Development: Learn the best practices for Starknet smart contracts.
• Specialized Tools: Access topic-specific tools for models, systems, testing, etc.

📦 Installation

Using Cursor

To add Sensei to the Cursor IDE:

1. Open Cursor settings (⌘+,).
2. Navigate to the "MCP" section.
3. Click "Add New MCP".
4. Configure as follows:
   • Name: Sensei (or any name you prefer).
   • Type: Command.
   • Command: npx github:dojoengine/sensei-mcp.
5. Click "Save".

After configuration, you can access Sensei in the following ways:

• Open the command palette (⌘+K).
• Type "MCP" and select "Open MCP Chat".
• Select "Sensei" from the MCP dropdown menu.

Sensei will provide you with assistance specifically tailored to Dojo and Cairo development, offering in - depth insights into Starknet development best practices.

Using Cursor Proxy

When using Sensei with the Cursor proxy, follow these best practices for optimal results:

1. Always mention specialized tools: Explicitly request the proxy to use Sensei's specialized tools (e.g., "Please use the dojo_model tool to help me create a model").

2. Follow an incremental development approach:

   • First, set up the project structure using dojo_101.
   • Define models using dojo_model.
   • Then implement systems using dojo_logic.
   • Finally, configure the project using dojo_config and add tests using dojo_test.

3. Be specific in your requests: For example, instead of asking "Help me complete a Dojo game", say "Please use the dojo_model tool to help me create a Position model for the game".

4. Break down complex tasks: Request help for one component at a time rather than asking for the entire game implementation at once.

Example prompt:

I'm building a Dojo game. Please tell me how to start.

Running Directly

To run directly in the terminal:

npx sensei-mcp

💻 Usage Examples

Basic Usage

# Create a new project
sensei-mcp init my-game

# Start the development server
cd my-game && npm run dev

# Create a model using dojo_model
npm run model create-character -- -r 3 -s Mage

# Test the game logic
npm test system combat-system.test.js

Advanced Usage

# Recommended development process
# Initialize the project
sensei-mcp init my-game
cd my-game

# Create core models
npm run model create-character -- -r 3 -s Warrior
npm run model create-character -- -r 5 -s Mage

# Implement basic system logic
npm run system implement -- -n combat-system

# Add the user interface
npm install react @dojo/core

# Test and iterate
npm test

🔧 Technical Details

Dojo System

• ECS Architecture: Efficiently manage game objects, components, and systems.
• Modular Design: Allows for easy expansion and maintenance of the codebase.
• Asynchronous Processing: Optimizes performance and ensures a smooth gaming experience.

📚 Documentation

Project Structure

my-game/
├── bin/                 # Executable scripts
├── src/                # Source code files
│   ├── models/         # Game models and logic
│   ├── systems/       # System implementations
│   └── prompts/       # Prompt texts
└── package.json        # Project dependencies and scripts

Building Guide

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

Through these steps, you can easily start using Sensei MCP for Dojo and Cairo development.