🚀 MCP Game Server

🚀 MCPlayerOne

想像力を AI 生成ゲームに変えましょう

MCPlayerOne へようこそ。シンセウェーブ、迷宮探索、ワールド構築を楽しめるアドベンチャープラットフォームです。AI が生成した自由な世界を作成し、探索してプレイしましょう。Next.js、Langflow、そしてあなたの想像力によって実現します。

世界を探索しましょう：ゲームプレイ例

---

🎮 MCP ツールで接続してプレイ

お気に入りのエージェントツールを使って公開 MCP ゲームサーバーに接続すれば、サーバーをセットアップすることなく、すぐにプレイできます！

🧪 Warp Preview（ターミナル）

1. Warp Preview をダウンロードしてインストールします
2. Warp Preview を開きます
3. Settings → Manage MCP servers → +Add の順に進みます
4. 次の内容を「SSE endpoint URL」フィールドに貼り付けます：

   https://mcplayerone.onrender.com/api/v1/mcp/sse
   

5. 保存して接続します！
   • Warp Preview から MCP ゲームサーバーを直接操作できるようになります。

🖥️ Cursor（AI IDE）

1. Cursor IDE をインストールします
2. MCP ゲームサーバーをツールサーバーとして追加します：
   • Cursor を開き、Extensions/Integrations に進みます。
   • 次の設定で新しい MCP ツールサーバーを追加します：

     {
       "MCPlayerOne": {
         "transportType": "sse",
         "url": "https://mcplayerone.onrender.com/api/v1/mcp/sse",
         "openapi": "https://mcplayerone.onrender.com/api/v1/mcp/openapi.json"
       }
     }
     

3. プレイを開始します！ Cursor のチャットやコードツールを使って MCP コマンドを送信したり、移動を自動化したり、ゲームデータを分析したりできます。

🤖 Claude（AI チャットボット／デスクトップ）

1. Python と pip をインストールします
2. uv をインストールします：

   pip install uv
   

3. mcp-proxy をインストールします：

   uvx install mcp-proxy
   

4. 次の内容を Claude Desktop の設定に追加します：

   {
     "mcpServers": {
       "MCPlayerOne": {
         "command": "uvx",
         "args": ["mcp-proxy", "https://mcplayerone.onrender.com/api/v1/mcp/sse"]
       }
     }
   }
   

5. Claude Desktop を再起動し、MCPlayerOne サーバーを選択してプレイを開始します！

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

• 404 または接続エラーが発生しますか？ 上記の正しい Render URL を使用していることを確認してください。
• エージェントが応答しませんか？ 正しい SSE エンドポイントと OpenAPI URL を使用していることを確認してください。
• セッションがタイムアウトしますか？ SSE セッションは、操作がない状態が 1 時間続くと終了します。必要に応じて再接続してください。

🚦 はじめに

すぐにゲームを始めたい場合も、自分のサーバーをセットアップしたい場合も、MCPlayerOne は簡単に始められます：

すぐにプレイする

• 上記の方法（Warp Preview、Cursor、Claude など）を使って公開 MCP ゲームサーバーに接続します。

接続したら、エージェントに MCPlayerOne のゲームをプレイしたいと伝えてください。

あとは、プレイしたいゲームをエージェントに伝えるだけです。必要に応じてユーザー名も指定できます（指定しない場合は、エージェントが選びます）。

自分のゲームを作成する

自分でゲームを作成し、生成してプレイすることもできます。

自由に楽しみましょう。ウェブサイトや GitHub リポジトリをテーマにしたり、テーマだけを指定したりできます。創造力や想像力を発揮するほど、ゲームは面白くなります。AI 生成の真価が発揮されるのは、まさにここです。

たとえば、エージェントに「新しい MCPlayerOne ゲームを作りましょう。テーマには github https://github.com/SonicDMG/mcp-game-server を使ってください」や「DOOM をテーマにして、宇宙海兵隊員としてプレイする新しい MCPlayerOne ゲームを作ってください」と伝えてみてください。

ゲームの作成には約 2～3 分かかりますので、お待ちください。

---

🎲 ゲームプレイ

🗝️ 利用可能な MCP ツール

以下は、あなた（またはエージェント）がゲームをプレイするために使用できる主な MCP ツールです。ほとんどのエージェントは、入力や目標に基づいてアクションを選択します。

ツール名	機能
listStories	プレイ可能なすべてのゲームストーリーを一覧表示します。
createGame	テーマに基づいて、新しいゲームストーリー、ロケーション、アイテム、カバー画像を生成します。
startGame	特定のストーリーでユーザーの新しいゲームセッションを開始します。すでに開始済みの場合は再開します。
getGameState	ユーザーとストーリーの現在のゲーム状態（プレイヤーとロケーション）を取得します。
lookAround	プレイヤーの現在のロケーションの詳細（説明、アイテム、出口）を取得します。
movePlayer	有効な場合、指定したターゲット ID のロケーションにプレイヤーを移動します。
takeItem	現在のロケーションにある指定アイテムを拾います。
examineTarget	現在の部屋にある特定のアイテムや特徴の詳細な説明を取得します。
getLeaderboard	特定のストーリーのリーダーボードデータを取得します。
getStoryById	論理 ID を指定して、特定のストーリーの詳細を取得します。

---

✨ 特徴

• 🪐 AI 生成ワールド：新しいストーリーや迷路をすぐに作成
• 👾 ASCII アートとピクセルアート：レトロなビジュアルとグリッドベースのレイアウト
• 🌌 リーダーボード：栄光を目指して競い、勝者と敗者を確認
• 🚀 アーティファクトと部屋：収集、探索、交流
• 🐉 シンセウェーブテーマ：ネオンカラー、ピクセルドラゴンなど
• 🧑‍💻 Langflow を活用：次世代の AI 統合

---

🛠️ ローカル開発

独自のサーバーを実行したり、開発に貢献したりしますか？以下の手順に従ってください：

npm install
npm run dev

http://localhost:3000 を開くと、ローカルでプレイできます。

• 必要に応じて .env を編集し、API キー、エンドポイント、ツールへのアクセスを設定します。
• Astra DB、Langflow、その他の統合については、.env.example 内のコメントに従ってください。

MCP ツールのセットアップ（ローカル開発向け）

• ローカル開発では、以下を使用します：
  • http://localhost:3000/api/v1/mcp/sse（SSE エンドポイント）
  • http://localhost:3000/api/v1/mcp/openapi.json（OpenAPI 仕様）
• ローカル開発では、すべての MCP ツールがデフォルトで有効になっています。

---

🌟 コントリビューション

プルリクエストを歓迎します！Issue を作成し、フォークして、メタバースで最もワイルドな世界を一緒に作りましょう。

• リポジトリにスターを付ける ⭐

---

🔗 リンク

• Langflow

---

📑 エラーとステータスコードのリファレンス（補遺）

このセクションでは、MCP Game Server API および SSE/JSON-RPC インターフェースで使用される主なエラーコードとステータスコードを、すぐに参照できるように説明します：

HTTP ステータスコード

コード	発生条件	意味
200	リクエストの成功（ゲームロジックのエラーが本文に含まれる場合があります）	OK
400	リクエストの形式不正、パラメーターの欠落または無効	Bad Request
403	許可されていないアクション（例：要件を満たしていない）	Forbidden
404	リソースが見つからない（プレイヤー、ストーリー、ロケーション、アイテム）	Not Found
409	競合（例：同じ ID のストーリーがすでに存在する）	Conflict
500	内部サーバーエラー	Server Error

JSON-RPC エラーコード（SSE/ツールプロキシ）

コード	発生条件	意味
-32000	一般的なサーバーエラー（プロキシの失敗、JSON 以外のレスポンスなど）	サーバーエラー（JSON-RPC 2.0 予約済み）
-32601	ツールまたはメソッドが見つからない	メソッドが見つからない（JSON-RPC 2.0）
-32602	ツールまたはメソッドのパラメーターが無効	パラメーターが無効（JSON-RPC 2.0）
-32603	内部 JSON-RPC エラー	内部エラー（JSON-RPC 2.0）

ゲームロジック／レスポンスフィールド

フィールド	表示される条件	意味
success	すべてのレスポンス	操作が成功した場合はtrue、そうでない場合はfalse
error	失敗時	ユーザー／エージェント向けのエラーメッセージ
hint	場合による	ユーザー／エージェント向けの任意のヒント
needsPlayer	プレイヤーが見つからない場合	クライアントが/startを呼び出す必要があることを示します

注意事項

• ゲームロジックのエラー（例：不正解、アイテム不足）では、HTTP 200とともに、本文にsuccess: falseとerrorメッセージが返されることがあります。
• エージェントとの互換性のため、SSEおよびツールのプロキシではJSON-RPCエラーコードが使用されます。
• スキーマの詳細については、OpenAPI仕様を参照してください。

---

ご訪問ありがとうございます、探検者さん！ 迷路が入り組み、アーティファクトが輝きますように。 🟪🟦🟩🟧🟨🟫