Sensei MCP

Sensei MCP

Sensei MCP は、Starknet での Dojo および Cairo 開発に専門的なガイダンスを提供する Model Context Protocol（MCP）サーバーです。個人用の Dojo Sensei として、Dojo Entity Component System（ECS）フレームワークを使用したオンチェーンワールドの構築に役立つ専門知識と支援を提供します。

特長

• Cairo の専門的なガイダンス：Cairo 独自の所有権、メモリ、型システムに関するサポートを受けられます
• Dojo ECS アーキテクチャ：Model、System、World のパターンについて学べます
• スマートコントラクト開発：Starknet のスマートコントラクトに関するベストプラクティス
• 専門ツール：モデル、システム、テストなど、トピック別のツールを利用できます

Cursor での使用

インストール

MCP サーバーのインストールと使用方法について詳しくは、Cursor の公式ドキュメントをご覧ください。

Cursor IDE に Sensei を追加するには：

1. Cursor のコマンドパレットを開きます（⌘+Shift+P）
2. 「Cursor Settings」と入力して設定メニューを開きます
3. 「MCP Tools」に移動し、「New MCP Server」をクリックします
4. mcp.json に次の設定を追加します：

{
  "mcpServers": {
    "sensei": {
      "type": "command",
      "command": "npx github:dojoengine/sensei-mcp",
      "enabled": true
    }
  }
}

5. ファイルを保存します

Cursor はサーバーの初期化を試みます。 初期化が完了すると、メニューは次のように表示されます：

注：Cursor がサーバーを認識する前に、ターミナルで npx github:dojoengine/sensei-mcp を実行して、サーバーを手動でインストールする必要がある場合があります。

使用方法

インストールすると、Cursor Agent は適切な場面で自動的に Sensei に問い合わせます。 最適な結果を得るには、次のベストプラクティスに従ってください。

1. 必ず専門ツールについて言及します：Sensei の専門ツールを使うよう、エージェントに明示的に依頼してください（例：「モデルの作成を手伝ってもらうために、dojo_model ツールを使ってください」）。

2. 段階的な開発アプローチに従います：

   • dojo_101 を使ってプロジェクトのセットアップから始めます
   • 最初に dojo_model を使ってモデルを定義します
   • 次に dojo_logic を使ってシステムを実装します
   • 最後に dojo_config を使ってプロジェクトを設定します
   • dojo_test を使ってテストを追加します

3. 依頼内容を具体的にします：たとえば、「Dojo ゲームについて手伝ってください」と尋ねる代わりに、「ゲーム用の Position モデルを作成するために、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 Code での使用

Claude Code に Sensei MCP を追加するには、次のコマンドを実行します：

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 プロジェクトの設定に関する重要なガイダンス
• dojo_logic：Dojo システムとゲームロジックの実装に関する専門的なガイダンス
• dojo_model：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は、次の分野に関する深い専門知識を備えています。

• Cairoプログラミング言語（独自の所有権、メモリ、型システムを含む）
• Dojo ECSアーキテクチャ（モデル、システム、World）
• 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