Sensei MCP

Sensei MCP

Sensei MCP 是一个 Model Context Protocol（MCP）服务，为在 Starknet 上进行 Dojo 和 Cairo 开发提供专家指导。它是你的个人 Dojo Sensei，提供专业知识和协助，帮助你使用 Dojo Entity Component System（ECS）框架构建链上世界。

功能

• Cairo 专家指导：获取有关 Cairo 特有的所有权、内存和类型系统的帮助
• Dojo ECS 架构：了解 Model、System 和 World 模式
• 智能合约开发：Starknet 智能合约的最佳实践
• 专业工具：使用针对 Model、System、测试等主题的工具

与 Cursor 搭配使用

安装

如需了解安装和使用 MCP 服务的更多信息，请参阅 Cursor 官方文档。

要将 Sensei 添加到你的 Cursor IDE：

1. 打开 Cursor 命令面板（⌘+Shift+P）
2. 输入 "Cursor Settings" 打开设置菜单
3. 前往 "MCP Tools"，然后点击 "New MCP Server"
4. 将以下配置添加到 mcp.json：

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

5. 保存文件

Cursor 将尝试初始化该服务。 初始化完成后，菜单应如下所示：

注意：你可能需要先在终端中运行 npx github:dojoengine/sensei-mcp 手动安装该服务，Cursor 才能检测到它。

使用

安装后，Cursor Agent 会在适当时机自动查询 Sensei。 遵循以下最佳实践，以获得最佳效果：

1. 始终提及专业工具：明确要求 Agent 使用 Sensei 的专业工具（例如：“请使用 dojo_model 工具帮我创建一个 Model。”）。

2. 遵循渐进式开发方法：

   • 使用 dojo_101 开始项目设置
   • 首先使用 dojo_model 定义 Model
   • 接着使用 dojo_logic 实现 System
   • 最后使用 dojo_config 配置项目
   • 使用 dojo_test 添加测试

3. 明确说明请求：例如，不要只说“帮我做 Dojo 游戏”，而要说“请使用 dojo_model 工具帮我为游戏创建一个 Position Model”。

4. 拆分复杂任务：一次请求一个组件的帮助，而不是一次性要求实现整个游戏。

提示词示例：

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.

与 Claude Code 搭配使用

要将 Sensei MCP 添加到 Claude Code，请运行以下命令：

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

直接运行

你也可以直接在终端中运行 Sensei MCP：

npx github:dojoengine/sensei-mcp

可用工具

Sensei 提供了用于 Dojo 开发各个方面的专业工具：

• dojo_101：面向初学者的 Dojo 开发入门介绍
• dojo_config：Dojo 项目配置的必要指导
• dojo_logic：实现 Dojo System 和游戏逻辑的专家指导
• dojo_model：创建和使用 Dojo Model 的专业指导
• dojo_test：编写 Dojo 应用测试的全面指南
• dojo_token：在 Dojo 中实现代币标准的详细指导

如何使用工具

与 Sensei 聊天时，可以提及工具名称来请求特定指导：

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

Sensei 会自动使用适当的工具（此处为 dojo_model）提供专业指导。

推荐的开发工作流

为获得最佳效果，请采用以下渐进式开发方法：

1. 项目设置（使用 dojo_101）

   • 使用 sozo init 初始化项目
   • 了解项目结构
   • 删除或替换样板代码

2. 定义模型（使用 dojo_model）

   • 创建游戏状态模型
   • 确保正确派生 trait
   • 正确设置关键字段

3. 实现系统（使用 dojo_logic）

   • 创建系统合约
   • 实现游戏机制
   • 处理状态变更

4. 项目配置（使用 dojo_config）

   • 设置 Scarb.toml
   • 配置 Dojo 配置文件
   • 管理依赖项

5. 测试（使用 dojo_test）

   • 编写全面的测试
   • 验证游戏逻辑

此工作流可帮助你以结构化、循序渐进的方式构建 Dojo 应用，并在开发的相应阶段充分利用各工具的专业知识。

核心专业知识

Sensei 在以下方面拥有深厚的专业知识：

• Cairo 编程语言（包括其独特的所有权、内存和类型系统）
• Dojo ECS 架构（模型、系统和 World）
• Starknet 上的智能合约开发
• 链上游戏开发的最佳实践

开发

项目结构

• bin/：包含可执行脚本
• src/：MCP 服务的源代码
• prompts/：Dojo 开发各方面的文本提示词
• resources/：提示词使用的其他资源

从源代码构建

# 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