Sensei MCP

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

特性

• 专家 Cairo 指导：获得有关 Cairo 独特的 ownership、memory 和 type 系统的帮助
• Dojo ECS 架构：了解 Models、Systems 和 World 模式
• 智能合约开发：Starknet 智能合约的最佳实践
• 专用工具：访问模型、系统、测试等主题的专用工具

安装

与 Cursor 一起使用

要将 Sensei 添加到您的 Cursor IDE：

1. 打开 Cursor 设置 (⌘+,)
2. 导航到“MCP”部分
3. 点击“添加新的 MCP”
4. 按照以下方式配置：
   • 名称：Sensei（或您喜欢的任何名称）
   • 类型：命令
   • 命令：npx github:dojoengine/sensei-mcp
5. 点击“保存”

配置完成后，您可以通过以下方式访问 Sensei：

• 打开命令面板 (⌘+K)
• 键入“MCP”并选择“打开 MCP 聊天”
• 从 MCP 下拉列表中选择“Sensei”

Sensei 将为您提供 Dojo 和 Cairo 开发问题的专业帮助，并深入了解 Starknet 开发的最佳实践。

与 Cursor Agent 一起使用

当将 Sensei 与 Cursor Agent 一起使用时，请遵循以下最佳实践以获得最佳结果：

1. 始终提及专用工具：明确要求 Agent 使用 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 工具来帮助我创建模型。

直接运行

您也可以直接运行 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 中实施 Token 标准的详细指南

如何使用工具

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

你能帮我理解如何在 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 编程语言（包括其独特的 ownership、memory 和 type 系统）
• Dojo ECS 架构（Models、Systems 和 World）
• 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