Sensei MCP

Sensei MCP

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

特性

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

与光标一起使用

安装

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

要将Sensei添加到您的Cursor IDE中，请执行以下操作：

1. 打开光标命令面板（⌘+Shift+P）
2. 键入“光标设置”打开设置菜单
3. 导航到“MCP工具”，然后单击“新建MCP服务器”
4. 将以下配置添加到 mcp.json:

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

1. 保存文件

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

注意：您可能需要通过运行以下命令手动安装服务器 npx github:dojoengine/sensei-mcp 在Cursor拿起它之前，请先在终端中打开它。

使用

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

1. 始终提及专用工具：明确要求代理使用Sensei的专用工具（例如，“请使用dojo_model工具帮助我创建模型”）。

1. 遵循增量开发方法:

- 使用以下命令开始项目设置 dojo_101 - 首先使用定义模型 dojo_model - 接下来使用 dojo_logic - 上次使用配置项目 dojo_config - 使用添加测试 dojo_test

1. 在你的要求中要具体：例如，与其问“帮助我玩Dojo游戏”，不如说“请使用Dojo_model工具帮助我为我的游戏创建一个位置模型。”

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

示例提示：

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代码

要将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项目的基本指南
• dojologic：关于实现Dojo系统和游戏逻辑的专家指导
• dojo模型：创建和使用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 - 了解项目结构 - 删除或替换样板代码

1. 定义模型 （使用 dojo_model)

- 创建游戏状态模型 - 确保特征推导正确 - 正确设置关键字段

1. 实施系统 （使用 dojo_logic)

- 创建系统合同 - 实施游戏机制 - 处理状态更改

1. 项目配置 （使用 dojo_config)

- 设置Scarb.toml - 配置Dojo配置文件 - 管理依赖关系

1. 测试 （使用 dojo_test)

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

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

核心专长

Sensei在以下领域拥有深厚的专业知识：

• 开罗编程语言（包括其独特的所有权、内存和类型系统）
• 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