AI游戏生成平台

MCPlayerOne是一个AI生成的迷宫探索和世界构建冒险平台,允许用户创建、探索和玩AI生成的游戏世界。

  • by SonicDMG
  • TypeScript
  • 混合部署
  • 6 星标
  • 更新于
在 GitHub 查看 SonicDMG/mcp-game-server

使用说明

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

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

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

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
    
  5. 保存并连接!
    • 现在,您可以直接从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"
        }
      }
      
  3. 开始玩吧! 使用Cursor的聊天工具或代码工具来发送MCP命令、自动化移动或分析游戏数据。

Claude(人工智能聊天机器人/桌面版)

  1. 安装Python和pip
  2. 安装 紫外线:
    pip install uv
    
  3. 安装 mcp-proxy:
    uvx install mcp-proxy
    
  4. 将此添加到您的Claude桌面配置中:
    {
      "mcpServers": {
        "MCPlayerOne": {
          "command": "uvx",
          "args": ["mcp-proxy", "https://mcplayerone.onrender.com/api/v1/mcp/sse"]
        }
      }
    }
    
  5. 重启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工具。大多数代理会根据您的输入或目标来选择行动。

工具名称 功能说明
列出故事 列出所有可玩的游戏故事。
创建游戏 根据主题生成新的游戏故事、地点、物品和封面图片。
开始游戏 为特定故事中的用户启动一个新的游戏会话,或如果已开始则继续
获取游戏状态 获取用户和故事当前的游戏状态(玩家和位置)。
四处看看 获取玩家当前位置的详细信息(描述、物品、出口)。
移动玩家 如果有效,则将玩家移动到新位置(通过目标ID)。
拿取物品 从当前位置拿起指定的物品。
检查目标 获取当前房间中特定物品或功能的详细描述。
获取排行榜 获取特定故事的排行榜数据。
根据ID获取故事 通过逻辑ID获取特定故事的详细信息。

✨ 特点

  • 🪐 月亮(或卫星) 人工智能生成的世界立即创建新的故事和迷宫
  • 👾 表情符号,通常表示外星人、幽灵或其他神秘生物,没有直接的中文对应词汇,可描述为“外星人”或“幽灵”等意象。 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工具。

🌟 贡献

欢迎提交拉取请求!请提出问题,进行分支复制,并帮助我们一起在元宇宙中构建最狂野的世界。

  • 给仓库加星⭐

🔗 链接


📑 错误与状态码参考(附录)

以下是根据您的要求翻译的内容:

本节文档记录了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
错误 失败时 用户/代理的错误信息

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

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

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