Sensei MCP

Sensei MCP 是一个模型上下文协议（MCP）服务器，为 Starknet 上的 Dojo 和 Cairo 开发提供专业指导。它充当你的个人 Dojo Sensei，提供使用 Dojo 实体组件系统（ECS）框架构建链上世界的专门知识和帮助。

功能

• Cairo 专业指导：获得关于 Cairo 独特的所有权、内存和类型系统的帮助
• Dojo ECS 架构：了解模型、系统和世界模式
• 智能合约开发：Starknet 智能合约的最佳实践
• 专用工具：访问针对模型、系统、测试等主题的特定工具

使用与 Cursor

安装

有关安装和使用 MCP 服务器的更多信息，请参阅官方 Cursor 文档。

要将 Sensei 添加到你的 Cursor IDE：

1. 打开 Cursor 命令面板（⌘+Shift+P）
2. 输入“Cursor 设置”以打开设置菜单
3. 导航到“MCP 工具”并点击“新建 MCP 服务器”
4. 在 mcp.json 中添加以下配置：

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

5. 保存文件

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

<img width="647" alt="2025-06-12 下午6点04分39秒截图" src="https://gips0.baidu.com/it/u=4048395714,2032563595&fm=3081&app=3081&f=PNG?w=1294&h=268" />

注意：在 Cursor 能够识别之前，你可能需要通过在终端运行 npx github:dojoengine/sensei-mcp 来手动安装该服务器。

使用

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

1. 始终提及专用工具：明确要求代理使用 Sensei 的专用工具（例如，“请使用 dojo_model 工具帮我创建一个模型”）。
2. 采用增量开发方法：
   • 使用 dojo_101 开始项目设置
   • 首先使用 dojo_model 定义模型
   • 接下来使用 dojo_logic 实现系统
   • 最后使用 dojo_config 配置项目
   • 使用 dojo_test 添加测试
3. 具体请求：例如，不要问“帮帮我做我的 Dojo 游戏”，而应该说“请使用 dojo_model 工具帮我创建游戏中的 Position 模型”。
4. 分解复杂任务：一次请求一个组件的帮助，而不是一次性请求整个游戏实现。

示例提示：

我正在构建一个 Dojo 游戏。首先，请使用 dojo_101 工具帮我设置项目结构。
之后，我需要使用 dojo_model 工具来创建模型的帮助。

使用与 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 系统和游戏逻辑的专业指导
• dojo_model：创建和操作 Dojo 模型的专门指导
• dojo_test：编写 Dojo 应用程序测试的全面指南
• dojo_token：在 Dojo 中实现令牌标准的详细指导

如何使用工具

与 Sensei 对话时，可以通过提及工具名称来请求特定指导：

你能帮我理解如何在 Dojo 中创建一个模型吗？

Sensei 将自动使用适当的工具（在这种情况下是 dojo_model）提供专门指导。

推荐开发工作流程

为了获得最佳效果，请遵循以下增量开发方法：

1. 项目设置（使用 dojo_101）
   • 使用 sozo init 初始化项目
   • 了解项目结构
   • 移除或替换样板代码
2. 定义模型（使用 dojo_model）
   • 创建游戏状态模型
   • 确保正确派生特性
   • 正确设置关键字段
3. 实现系统（使用 dojo_logic）
   • 创建系统合约
   • 实现游戏机制
   • 处理状态变化
4. 项目配置（使用 dojo_config）
   • 设置 Scarb.toml
   • 配置 Dojo 配置文件
   • 管理依赖项
5. 测试（使用 dojo_test）
   • 编写全面的测试
   • 验证游戏逻辑

此工作流程确保你以结构化、有条理的方式构建 Dojo 应用程序，在开发的每个阶段充分利用每个工具的专业知识。

核心专长

Sensei 深入了解：

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

开发

项目结构

• bin/：包含可执行脚本
• src/：MCP 服务器的源代码
• prompts/：针对 Dojo 开发不同方面的文本提示
• resources/：提示使用的附加资源

从源码构建

# 克隆仓库
git clone https://github.com/dojoengine/sensei-mcp.git
cd sensei-mcp

# 安装依赖
npm install

# 构建项目
npm run build

# 启动服务器
npm start