MCP Game Server

MCP Game Server Logo

🚀 MCPlayerOne（可译为“🚀 我是MC玩家一号”或根据具体语境调整为更贴切的表述，但“MCPlayerOne”本身作为专有名词或特定标识，直接翻译可能不常见，故保留原样并稍作解释性翻译）

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

欢迎来到 MCPlayerOne（可译为“MC玩家一号”或根据具体语境调整为更贴切的表述） ——一款融合了合成波音乐、迷宫探索与世界构建的冒险平台游戏！在由AI生成的狂野世界中创造、探索与游玩。基于Next.js技术打造， Langflow（注：Langflow是一个假设或特定的名称，直接翻译为“语言流程”或根据上下文可能有更具体的含义，但在此处保持原样以体现其特定性），以及你的想象力。

App Screenshot

Explore your world: Example gameplay

______________________________________________________________________

🎮 通过MCP工具连接并游玩

您只需使用您喜爱的代理工具连接到公共MCP游戏服务器，即可立即开始游戏——无需服务器设置！

🧪 Warp 预览（终端）

1. 下载并安装 扭曲预览
2. 打开扭曲预览
3. 首选 Settings → Manage MCP servers → +Add
4. 将以下内容粘贴到“SSE 端点 URL”字段中：

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

1. 保存并连接！

- 现在，您可以直接从Warp预览中与MCP游戏服务器进行交互。

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

1. 安装 Cursor 集成开发环境（IDE）
2. 将MCP游戏服务器添加为工具服务器：

- 打开光标并转到“扩展/集成”部分。 - 使用此配置添加一个新的MCP工具服务器：

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

1. 开始玩吧！ 使用Cursor的聊天工具或代码工具来发送MCP命令、自动化移动或分析游戏数据。

Claude（人工智能聊天机器人/桌面版）

1. 安装Python和pip
2. 安装 紫外线:

   pip install uv

1. 安装 mcp-proxy：

   uvx install mcp-proxy

1. 将此添加到您的Claude桌面配置中：

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

1. 重启Claude桌面版 并选择MCPlayerOne服务器开始游戏！

🛠️ 故障排除

• 404错误还是连接错误？ 确保你使用的是上述正确的渲染URL。
• 代理没有响应？ 请确认您正在使用正确的SSE终端节点和OpenAPI URL。
• 会话超时了吗？ SSE（服务器发送事件）会话在1小时无活动后会断开——如有需要，请重新连接。

🚦 开始使用

无论你是想直接加入游戏，还是想搭建自己的服务器，开始使用MCPlayerOne都非常简单：

立即播放

• 使用上述任意一种方法（扭曲预览、光标、Claude 等）连接到公共 MCP 游戏服务器。

一旦连接成功，请告诉客服您想玩一个MCPlayerOne游戏。

Start an MCPlayerOne Game

Pick a Game and Play

现在，只需告诉客服您想玩的游戏，并可选择性地为自己设定一个用户名（如果您不设定，客服会为您选择一个）。

创建你自己的游戏

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

尽情享受这个过程吧，把目标指向一个网站，比如一个GitHub仓库，或者只是给它设定一个主题。你的创意和想象力越丰富，你的游戏就越有趣。这就是人工智能生成技术真正闪耀的地方。

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

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

______________________________________________________________________

🎲 游戏玩法

🗝️ 可用的MCP工具

这些是您（或您的代理）可以用来进行游戏的主要MCP工具。大多数代理会根据您的输入或目标来选择行动。

______________________________________________________________________

✨ 特点

• 🪐 月亮（或卫星） 人工智能生成的世界立即创建新的故事和迷宫
• 👾 表情符号，通常表示外星人、幽灵或其他神秘生物，没有直接的中文对应词汇，可描述为“外星人”或“幽灵”等意象。 ASCII & 像素艺术复古视觉与网格布局
• 🌌 无直接对应中文翻译，该符号常用于表示宇宙、星空或神秘感，可意译为“浩瀚宇宙”或根据上下文灵活表达。 排行榜争夺荣耀，见证胜利者与失败者
• 🚀 这个表情符号通常代表火箭或快速上升、进步的意思，可以翻译为“🚀（火箭/快速上升/进步）”。在具体语境中，可以根据需要选择最合适的翻译。 文物与房间收集、探索和互动
• 🐉 神龙 合成波主题霓虹色彩，像素龙，以及更多
• 🧑‍💻 表示“打字员”或“电脑前的人”。 由……提供支持/驱动 Langflow高级别的人工智能集成

______________________________________________________________________

🛠️ 本地开发

想要运行自己的服务器或做出贡献？请按照以下步骤操作：

npm install
npm run dev

开放 http://localhost:3000 翻译为中文是：“本地主机：3000 端口”。不过，通常我们不会直接翻译网址，而是根据上下文解释其含义，比如“这是运行在本地计算机上的一个服务或应用的地址，监听 3000 端口”。但按照您的要求，直接翻译网址部分就是“本地主机：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状态码

| 409 | 冲突（例如，存在相同ID的故事） | 冲突 |

| 500 | 内部服务器错误 | 服务器错误 | JSON-RPC 错误代码（SSE/工具代理）

| -32602 | 工具/方法的参数无效 | 参数无效（JSON-RPC 2.0） |

| -32603 | 内部 JSON-RPC 错误 | 内部错误（JSON-RPC 2.0） | 游戏逻辑/响应字段

| 提示 | 有时 | 供用户/代理使用的可选提示 |

• | needsPlayer | 玩家未找到 | 表示客户端应调用 /start | success: false 注释 error 游戏逻辑错误（例如，答案错误、缺少项目）可能会返回HTTP 200状态码，并且
• 和一个
• 正文中的信息。

______________________________________________________________________

JSON-RPC 错误代码在服务器发送事件（SSE）和工具代理中用于确保代理兼容性。 请参阅OpenAPI规范以获取完整的模式详细信息。