Sensei MCP

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

功能

• Cairo 专家指导：获得关于 Cairo 独特的所有权、内存和类型系统的帮助
• Dojo ECS 架构：了解模型、系统和世界模式
• 智能合约开发：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. 始终提及专业工具：明确要求代理使用 Sensei 的专业工具（例如，“请使用 dojo_model 工具帮我创建一个模型”）。

2. 遵循增量开发方法：

   • 使用 dojo_101 开始项目设置
   • 使用 dojo_model 先定义模型
   • 接下来使用 dojo_logic 实现系统
   • 最后使用 dojo_config 配置项目
   • 使用 dojo_test 添加测试

3. 在请求中具体说明：例如，不要问“帮帮我做我的 Dojo 游戏”，而是说“请使用 dojo_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.

直接运行

您也可以直接运行 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 聊天时，您可以提到工具名称来请求特定的指导：

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 架构（模型、系统和世界）
• 在 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