金大哥 - sensei-mcp MCP 详情

article

README

🚀 术士MCP

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

🚀 快速开始

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

✨ 主要特性

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

📦 安装指南

使用Cursor

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

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

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

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

使用Cursor代理

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

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

示例提示：

我在构建一个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

🔧 技术细节

道场系统

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开发。

sensei-mcp