Dojo开发指导服务

Sensei MCP是一个为Starknet上的Dojo和Cairo开发提供专家指导的模型上下文协议服务器,帮助开发者构建基于Dojo实体组件系统(ECS)框架的链上世界。

  • by dojoengine
  • TypeScript
  • 本地部署
  • 13 星标
  • 更新于
在 GitHub 查看 dojoengine/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工具帮助我创建模型”)。

  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.

使用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
    • 了解项目结构
    • 删除或替换样板代码
  2. 定义模型 (使用 dojo_model)

    • 创建游戏状态模型
    • 确保特征推导正确
    • 正确设置关键字段
  3. 实施系统 (使用 dojo_logic)

    • 创建系统合同
    • 实施游戏机制
    • 处理状态更改
  4. 项目配置 (使用 dojo_config)

    • 设置Scarb.toml
    • 配置Dojo配置文件
    • 管理依赖关系
  5. 测试 (使用 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