🚀 MCPlayerOne

将你的想象转化为由AI生成的游戏

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

<p align="center"><i>探索你的世界：示例游戏玩法</i></p>

---

🎮 通过MCP工具连接并游玩

你可以通过连接到公共MCP游戏服务器来立即开始游玩，使用你最喜欢的代理工具——无需设置服务器！

🧪 Warp Preview（终端）

1. 下载并安装Warp Preview
2. 打开Warp Preview
3. 前往设置 → 管理MCP服务器 → +添加
4. 在"SSE端点URL"字段中粘贴以下内容：

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

5. 保存并连接！
   • 现在你可以直接从Warp Preview与MCP游戏服务器进行交互。

🖥️ Cursor（AI集成开发环境）

1. 安装Cursor IDE
2. 将MCP游戏服务器作为工具服务器添加：
   • 打开Cursor并进入扩展/集成。
   • 使用以下配置添加一个新的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游戏。

<div align="center" style="display: flex; gap: 24px; justify-content: center;"> <div> <img src="public/images/claude-example-game-start.png" alt="在Claude中开始游戏" width="320" height="320"/> <div align="center"><i>开始MCPlayerOne游戏</i></div> </div> <div> <img src="public/images/claude-example-choose-game.png" alt="在Claude中玩游戏" width="320" height="320"/> <div align="center"><i>选择游戏并开始</i></div> </div> </div>

现在，只需告诉代理你想玩哪个游戏，并可选地给自己起个用户名（如果没起名，代理会为你选择一个）。

创建自己的游戏

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

尽情发挥创意吧，指向一个网站，也许是一个GitHub仓库，或者只是给它一个主题。越有创意和想象力，你的游戏就越有趣。这是AI生成真正闪耀的地方。

例如，告诉代理类似“让我们创建一个新的MCPlayerOne游戏，使用GitHub https://github.com/SonicDMG/mcp-game-server 作为主题”或“创建一个新的MCPlayerOne游戏，以DOOM为主题，扮演太空海军陆战队员”。

游戏创建大约需要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工具在本地开发中都是启用的。

---

🌟 贡献

欢迎提交拉取请求！开启问题、分叉并帮助我们构建元宇宙中最疯狂的世界。

• 给仓库点赞 ⭐

---

🔗 链接

• Langflow

---

📑 错误及状态码参考（附录）

本节记录了MCP游戏服务器API和SSE/JSON-RPC接口使用的主错误和状态码，供快速参考：

HTTP状态码

代码	发布情况	含义
200	成功请求（可能包括游戏逻辑中的错误）	OK
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	失败时	用户/代理的错误消息
hint	有时	可选提示给用户/代理
needsPlayer	未找到玩家	表明客户端应调用/start

注意事项

• 游戏逻辑错误（如答案错误、缺少物品）可能会返回HTTP 200和success: false以及带有错误消息的主体。
• JSON-RPC错误码用于SSE和工具代理，以确保代理兼容性。
• 请参阅OpenAPI规范以获取完整的模式细节。

---

感谢访问，探险家！ 愿你的迷宫曲折蜿蜒，你的文物闪闪发光。 🟪🟦🟩🟧🟨🟫