Engine Openapi MCP

🚀 神岛引擎 OpenAPI MCP ツールセット

神岛引擎 OpenAPI MCP ツールセットは、神岛エンジンとのインターフェースツールです。開発者がゲームロジック、データストレージ、AI 支援機能をより効率的に管理できるように設計されています。このツールセットは、スクリプト管理、データストレージ管理、AI 強化機能をカバーし、ブラウザと Node.js 環境の両方で使用できます。

🚀 クイックスタート

このツールセットを使用することで、開発者はゲームロジックとデータストレージを効率的に管理し、AI 支援機能を通じて開発効率とコード品質を向上させることができます。

✨ 主な機能

スクリプト管理

• 保存/更新スクリプト：開発者が神島エンジンにゲームロジックスクリプトをアップロードまたは更新できます。
• スクリプトのリネーム：スクリプトを簡単にリネームし、コードを整理します。
• コードレビュー：AI 支援機能がコード内の潜在的な問題を自動検出し、提案を提供します。
• コード生成と最適化：効率的で安全なゲームロジックコードを自動生成し、最新のベストプラクティスに基づいて最適化します。

データストレージ管理

• 基本操作 (CRUD)：プレイヤー統計データやゲームアイテム情報などのシナリオで、データの作成、読み取り、更新、削除操作をサポートします。
• ページングクエリ：大量のデータをページング機能で処理し、システムのパフォーマンスと応答速度を向上させます。
• データ構造の設計と移行：AI 支援ツールが効率的なデータモデルを設計し、新しいデータ構造の要件に対応する移行スクリプトを生成します。

AI 支援機能

• コード最適化：AI 技術を利用してコード品質を向上させ、潜在的なエラーを減らし、可読性を高めます。
• データモデリングと分析：AI ツールが過去のデータと使用シナリオに基づいて適切なデータモデルを推奨し、データ分析を行って潜在的な問題を発見します。

📦 インストール

ブラウザでの統合

import { McpClient } from "@modelcontextprotocol/sdk/client/index.js";

// クライアントを初期化する
const mcpClient = new McpClient({
  serverUrl: "https://your-mcp-server.com",
  headers: {
    "Content-Type": "application/json",
  },
});

// ツールの使用例
async function useTools() {
  const result = await mcpClient.callTool("script.list", {
    mapId: "your-map-id",
    token: "your-token",
    userAgent: "your-user-agent"
  });
  
  // 結果を処理する
  console.log(result);
}

Node.js での統合

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { WebSocketClientTransport } from "@modelcontextprotocol/sdk/client/websocket.js";

// トランスポートチャネルを作成する
const transport = new WebSocketClientTransport({
  url: "ws://localhost:3000",
});

// クライアントを初期化して接続する
const client = new Client(
  { name: "dao3-client", version: "1.0.0" },
  { capabilities: { tools: {} } }
);
await client.connect(transport);

// ツールの使用例
const result = await client.callTool({
  name: "script.list",
  arguments: {
    mapId: "your-map-id",
    token: "your-token",
    userAgent: "your-user-agent"
  },
});

🔧 認証メカニズム

すべての API 呼び出しには、以下の認証情報が必要です。

• token：ユーザーの身元を検証するための承認トークン。
• userAgent：リクエストの送信元を識別するユーザーエージェント文字列。

認証情報の取得手順

1. 神島エンジン開発者プラットフォームにアクセスする：神島エンジン開発者プラットフォームにログインして、開発者キーを取得します。
2. 認証トークンを生成する：開発者キーを使用して、有効な API 呼び出しトークンを生成します。
3. 呼び出しに渡す：生成された token とカスタムの userAgent 文字列を、各 API リクエストに含めます。

🛠️ トラブルシューティング

リクエストタイムアウトの問題

リクエストがタイムアウトした場合は、以下の原因を確認してください。

• ネットワークの不安定：ネットワーク接続が正常であることを確認し、データ転送量を減らすか、別のネットワークを試してみます。
• サーバーの負荷が高い：非ピーク時間にリクエストを再試行するか、リクエスト内容を最適化してデータ量を減らします。
• データが大きい：一度に大量のデータを転送しないように、各リクエストのデータ量を制限します。

型エラーの問題

ドキュメントで指定されたパラメーターの型に厳密に従って値を渡すようにしてください。

• 数値パラメーター（例：limit、offset）は、数値型である必要があります。
• ブール値パラメーター（例：isGroup）は、正しくブール型に設定する必要があります。

🤝 貢献ガイド

このプロジェクトを改善するために、問題報告や Pull Request を送信することを歓迎します！

1. プロジェクトリポジトリをフォークする：GitHub で神島エンジン OpenAPI MCP ツールセットのリポジトリをフォークします。
2. 変更をコミットする：main ブランチをベースにコードを変更し、開発用の新しい機能ブランチを作成します。
3. Pull Request を送信する：機能ブランチを Pull Request として送信し、コードレビューと議論に参加します。

このツールセットを使用することで、開発者はゲームロジックとデータストレージをより効率的に管理でき、AI 支援機能を通じて開発効率とコード品質を向上させることができます。