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開發。