mcp-game-server

🚀 MCPlayerOne

Turn your imagination into an AI generated game

Welcome to the MCPlayerOne — a synthwave, maze-crawling, world-building adventure platform! Create, explore, and play in wild, AI-generated worlds. Powered by Next.js, Langflow, and your imagination.

Explore your world: Example gameplay

🎮 Connect & Play via MCP Tools

You can play instantly by connecting to the public MCP Game Server using your favorite agent tools—no server setup required!

🧪 Warp Preview (Terminal)

1. Download and install Warp Preview
2. Open Warp Preview
3. Go to Settings → Manage MCP servers → +Add
4. Paste the following into the "SSE endpoint URL" field:

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

5. Save and connect!
   • You can now interact with the MCP Game Server directly from Warp Preview.

🖥️ Cursor (AI IDE)

1. Install Cursor IDE
2. Add the MCP Game Server as a tool server:
   • Open Cursor and go to Extensions/Integrations.
   • Add a new MCP tool server with this config:

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

3. Start playing! Use Cursor's chat or code tools to send MCP commands, automate moves, or analyze game data.

🤖 Claude (AI Chatbot/Desktop)

1. Install Python and pip
2. Install uv:

   pip install uv
   

3. Install mcp-proxy:

   uvx install mcp-proxy
   

4. Add this to your Claude Desktop config:

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

5. Restart Claude Desktop and select the MCPlayerOne server to start playing!

🛠️ Troubleshooting

• 404 or connection errors? Make sure you're using the correct Render URL above.
• Agent not responding? Check that you're using the correct SSE endpoint and OpenAPI URL.
• Session timeouts? SSE sessions last for 1 hour of inactivity—just reconnect if needed.

🚦 Getting Started

Whether you want to jump right into a game or set up your own server, getting started with MCPlayerOne is easy:

To Play Instantly

• Use any of the methods above (Warp Preview, Cursor, Claude, etc.) to connect to the public MCP Game Server.

Once connected, tell the agent you would like to play an MCPlayerOne game.

Start an MCPlayerOne Game

Pick a Game and Play

Now, just tell the agent which game you'd like to play and optionally give yourself a username (the agent will choose one for you if you don't).

Create your own game

You can also create and generate your own game to play.

Have fun with it, point it at a website, maybe a GitHub repo, or just give it a theme. The more creative and imaginative you are the more interesting your game. This is where AI generation really shines.

For example, tell the agent something like "Let's create a new MCPlayerOne game, use github https://github.com/SonicDMG/mcp-game-server for the theme" or "Create a new MCPlayerOne game with a theme based on DOOM playing as a space marine".

Game creation takes about 2-3 minutes so please be patient.

🎲 Gameplay

🗝️ Available MCP Tools

These are the main MCP tools you (or your agent) can use to play. Most agents will choose actions based on your input or goals.

✨ Features

• 🪐 AI-Generated Worlds: Instantly create new stories and mazes
• 👾 ASCII & Pixel Art: Retro visuals and grid-based layouts
• 🌌 Leaderboard: Compete for glory, see winners and the fallen
• 🚀 Artifacts & Rooms: Collect, explore, and interact
• 🐉 Synthwave Theme: Neon colors, pixel dragons, and more
• 🧑‍💻 Powered by Langflow: Next-level AI integration

🛠️ Local Development

Want to run your own server or contribute? Follow these steps:

npm install
npm run dev

Open http://localhost:3000 to play locally.

• Edit .env to set up API keys, endpoints, or tool access as needed.
• For Astra DB, Langflow, or other integrations, follow the comments in .env.example.

MCP Tool Setup (for local dev)

• For local dev, use:
  • http://localhost:3000/api/v1/mcp/sse (SSE endpoint)
  • http://localhost:3000/api/v1/mcp/openapi.json (OpenAPI spec)
• All MCP tools are enabled by default in local dev.

🌟 Contributing

Pull requests are welcome! Open an issue, fork, and help us build the wildest worlds in the metaverse.

• Star the repo ⭐

🔗 Links

• Langflow

📑 Error & Status Code Reference (Addendum)

This section documents the main error and status codes used by the MCP Game Server API and SSE/JSON-RPC interface, for quick reference:

HTTP Status Codes

JSON-RPC Error Codes (SSE/Tool Proxy)

Game Logic/Response Fields

Notes

• Game logic errors (e.g., wrong answer, missing item) may return HTTP 200 with success: false and an error message in the body.
• JSON-RPC error codes are used in SSE and tool proxying for agent compatibility.
• See the OpenAPI spec for full schema details.

Thanks for visiting, explorer! May your mazes be twisty and your artifacts shiny. 🟪🟦🟩🟧🟨🟫