sensei-mcp

Sensei MCP is a Model Context Protocol (MCP) server that provides expert guidance for Dojo and Cairo development on Starknet. It serves as your personal Dojo Sensei, offering specialized knowledge and assistance for building onchain worlds using the Dojo Entity Component System (ECS) framework.

• Expert Cairo Guidance: Get help with Cairo's unique ownership, memory, and type systems
• Dojo ECS Architecture: Learn about Models, Systems, and World patterns
• Smart Contract Development: Best practices for Starknet smart contracts
• Specialized Tools: Access topic-specific tools for models, systems, testing, and more

To add Sensei to your 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"

Once configured, you can access Sensei by:

• Opening the command palette (⌘+K)
• Typing "MCP" and selecting "Open MCP Chat"
• Selecting "Sensei" from the MCP dropdown

Sensei will provide specialized assistance for your Dojo and Cairo development questions, with deep knowledge of Starknet development best practices.

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

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

2. Follow the incremental development approach:

   • Start with project setup using dojo_101
   • Define models first using dojo_model
   • Implement systems next using dojo_logic
   • Configure the project last using dojo_config
   • Add tests using dojo_test

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

4. Break down complex tasks: Ask for help with one component at a time rather than requesting an entire game implementation at once.

Example 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.

You can also run Sensei MCP directly:

npx github:dojoengine/sensei-mcp

Sensei provides specialized tools for different aspects of Dojo development:

• dojo_101: Beginner-friendly introduction to Dojo development
• dojo_config: Essential guidance for configuring Dojo projects
• dojo_logic: Expert guidance on implementing Dojo systems and game logic
• dojo_model: Specialized guidance for creating and working with Dojo models
• dojo_test: Comprehensive guide for writing tests for Dojo applications
• dojo_token: Detailed guidance on implementing token standards in Dojo

When chatting with Sensei, you can ask for specific guidance by mentioning the tool name:

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

Sensei will automatically use the appropriate tool (in this case, dojo_model) to provide specialized guidance.

For the best results, follow this incremental development approach:

1. Project Setup (use dojo_101)

   • Initialize your project with sozo init
   • Understand the project structure
   • Remove or replace boilerplate code

2. Define Models (use dojo_model)

   • Create your game state models
   • Ensure proper trait derivation
   • Set up key fields correctly

3. Implement Systems (use dojo_logic)

   • Create system contracts
   • Implement game mechanics
   • Handle state changes

4. Project Configuration (use dojo_config)

   • Set up Scarb.toml
   • Configure Dojo profiles
   • Manage dependencies

5. Testing (use dojo_test)

   • Write comprehensive tests
   • Verify game logic

This workflow ensures you build your Dojo application in a structured, methodical way, leveraging the specialized knowledge of each tool at the appropriate stage of development.

Sensei has deep expertise in:

• Cairo programming language (including its unique ownership, memory, and type system)
• Dojo ECS architecture (Models, Systems, and World)
• Smart contract development on Starknet
• Best practices for onchain game development

• bin/: Contains the executable script
• src/: Source code for the MCP server
• prompts/: Text prompts for different aspects of Dojo development
• resources/: Additional resources used by the prompts

# 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