🚀 MCP Game Server

🚀 MCPlayerOne

将你的想象变成 AI 生成的游戏

欢迎来到 MCPlayerOne——一个合成波风格、迷宫探索、世界构建的冒险平台！在狂野的 AI 生成世界中创造、探索和游玩。由 Next.js、Langflow 和你的想象力驱动。

探索你的世界：游戏示例

---

🎮 通过 MCP 工具连接并游玩

你可以使用自己喜欢的 Agent 工具连接到公共 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。
• Agent 没有响应？ 请检查使用的 SSE 端点和 OpenAPI URL 是否正确。
• 会话超时？ SSE 会话在闲置 1 小时后过期——如有需要，只需重新连接即可。

🚦 快速入门

无论你想立即开始游戏，还是设置自己的服务器，MCPlayerOne 都能让你轻松上手：

立即开始游戏

• 使用上述任一方式（Warp Preview、Cursor、Claude 等）连接到公共 MCP 游戏服务。

连接后，告诉 Agent 你想玩一局 MCPlayerOne 游戏。

现在，只需告诉 Agent 你想玩哪款游戏，也可以给自己起个用户名（如果你不提供，Agent 会替你选择一个）。

创建自己的游戏

你也可以创建并生成自己的游戏来玩。

尽情发挥吧，可以让它参考某个网站、GitHub 仓库，或者只给它一个主题。你越有创意、想象力越丰富，游戏就会越有趣。这正是 AI 生成大显身手的地方。

例如，可以告诉 Agent：“我们来创建一款新的 MCPlayerOne 游戏，以 github https://github.com/SonicDMG/mcp-game-server 为主题”，或者“创建一款以 DOOM 为主题、扮演太空陆战队员的 MCPlayerOne 新游戏”。

创建游戏大约需要 2-3 分钟，请耐心等待。

---

🎲 游戏玩法

🗝️ 可用的 MCP 工具

以下是你（或你的 Agent）可以用来游玩的主要 MCP 工具。大多数 Agent 会根据你的输入或目标来选择行动。

工具名称	功能说明
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 工具。

---

🌟 贡献

欢迎提交拉取请求！请提出问题、复刻仓库，并帮助我们打造元宇宙中最狂野的世界。

• 为仓库点亮星标 ⭐

---

🔗 链接

• Langflow

---

📑 错误和状态码参考（补充）

本节记录了 MCP Game Server API 和 SSE/JSON-RPC 接口使用的主要错误和状态码，方便快速查阅：

HTTP 状态码

代码	触发时机	含义
200	请求成功（游戏逻辑错误可能包含在响应正文中）	正常
400	请求格式错误，参数缺失或无效	错误请求
403	不允许执行操作（例如，未满足要求）	禁止访问
404	未找到资源（玩家、故事、地点、物品）	未找到
409	冲突（例如，已存在相同 ID 的故事）	冲突
500	内部服务器错误	服务器错误

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	失败时	面向用户/Agent 的错误消息
hint	有时	面向用户/Agent 的可选提示
needsPlayer	未找到玩家	表示客户端应调用 /start

说明

• 游戏逻辑错误（例如答案错误、缺少物品）可能会返回 HTTP 200，并在响应正文中包含 success: false 和 error 消息。
• SSE 和工具代理使用 JSON-RPC 错误代码，以兼容 Agent。
• 完整的架构详情请参阅 OpenAPI 规范。

---

感谢你的到访，探索者！ 愿你的迷宫曲折多变，宝物熠熠生辉。🟪🟦🟩🟧🟨🟫