Sensei MCP

🚀 术士MCP

术士MCP是一个模型上下文协议（MCP）服务器，它能为Dojo和Cairo在Starknet上的开发提供专家级指导。就像您专属的道场老师一样，它能提供专业知识与支持，助力您使用Dojo实体组件系统（ECS）框架构建链上世界。

🚀 快速开始

术士MCP能为您在Starknet上进行Dojo和Cairo开发提供专门的协助，让您深入了解Starknet开发的最佳实践。

✨ 主要特性

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

📦 安装指南

使用Cursor

要在Cursor IDE中添加术士，可按以下步骤操作：

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

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

• 打开命令调色板（⌘+K）
• 输入“MCP”并选择“打开MCP聊天”
• 从MCP下拉菜单中选择“术士”

使用Cursor代理

当使用术士与Cursor代理时，请遵循以下最佳实践以获得最佳效果：

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

示例提示：

我在构建一个Dojo游戏。请告诉我如何开始。

直接运行

要在终端中直接运行，可使用以下命令：

npx sensei-mcp

💻 使用示例

提供的工具

• dojo_101：帮助您快速入门道场开发的基础知识和提示。
• dojo_model：用于创建和管理道场模型的高级工具，包括战斗系统和角色属性。
• dojo_system：处理复杂的游戏逻辑，如任务生成和事件触发。
• dojo_config：配置项目设置，优化性能，并管理游戏资源。

工具使用示例

# 创建新项目
sensei-mcp init my-game

# 启动开发服务器
cd my-game && npm run dev

# 使用dojo_model创建模型
npm run model create-character -- -r 3 -s Mage

# 测试游戏逻辑
npm test system combat-system.test.js

推荐的开发流程

1. 初始化项目

sensei-mcp init my-game
cd my-game

2. 创建核心模型

npm run model create-character -- -r 3 -s Warrior
npm run model create-character -- -r 5 -s Mage

3. 实现基本系统逻辑

npm run system implement -- -n combat-system

4. 添加用户界面

npm install react @dojo/core

5. 测试和迭代

npm test

🔧 技术细节

道场系统

• ECS架构：高效管理游戏对象、组件和系统。
• 模块化设计：允许轻松扩展和维护代码库。
• 异步处理：优化性能，确保流畅的游戏体验。

📚 详细文档

项目结构

my-game/
├── bin/                 # 可执行脚本
├── src/                # 源代码文件
│   ├── models/         # 游戏模型和逻辑
│   ├── systems/       # 系统实现
│   └── prompts/       # 提示文本
└── package.json        # 项目依赖和脚本

构建指南

1. 克隆仓库

git clone https://github.com/dojoengine/sensei-mcp.git
cd sensei-mcp

2. 安装依赖

npm install

3. 构建项目

npm run build

4. 启动服务器

npm start

通过以上步骤，您可以轻松开始使用术士MCP进行道场和Cairo开发。