术士MCP

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

特性

• 专家级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下拉菜单中选择“术士”

术士将为您提供专门针对道场和Cairo开发的协助，深入了解Starknet开发最佳实践。

使用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        # 项目依赖和脚本

构建指南

克隆仓库

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

安装依赖

npm install

构建项目

npm run build

启动服务器

npm start

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