使用说明

项目简介

Devvit-Phaser 是一个用于构建基于 Phaser.js 和 Reddit Devvit 平台的多人互动游戏的库。此仓库包含一个 MCP (Model Context Protocol) 服务器,用于辅助测试基于 Devvit-Phaser 构建的游戏。

主要功能点

  • 浏览器测试: 启动、导航和操作 Web 浏览器,用于自动化游戏在浏览器中的测试。
  • Devvit Playtest 管理: 启动、监控和管理 Devvit Playtest 环境,方便进行游戏 Playtest。
  • 日志访问: 提供 Devvit Playtest 日志的访问,用于分析和调试。

安装步骤

可以通过以下两种方式安装 MCP 服务器:

方式一:全局安装 (推荐)

npm install -g devvit-phaser

升级时,建议先卸载旧版本以避免冲突:

npm uninstall -g devvit-phaser
npm install -g devvit-phaser

方式二:从仓库安装

  1. 克隆仓库到本地:
    git clone https://github.com/fizx/devvit-phaser.git
    cd devvit-phaser
  2. 安装依赖并构建 MCP 服务器:
    npm run build:mcp

服务器配置

MCP 服务器通过 stdio 进行通信,无需复杂的配置。

以下是 MCP 客户端连接服务器时可能需要的配置信息(JSON 格式):

{
  "serverName": "Devvit-Phaser MCP Server",
  "command": "devvit-phaser-mcp",
  "args": [],
  "protocol": "stdio",
  "description": "Devvit-Phaser MCP 服务器,用于测试 Devvit-Phaser 游戏",
  "capabilities": {
    "resources": {},
    "tools": {}
  }
}

参数说明:

  • 'serverName': 服务器名称,可以自定义。
  • 'command': 启动 MCP 服务器的命令。
    • 全局安装时,使用 'devvit-phaser-mcp'。
    • 从仓库安装时,使用 'npm run start:mcp' (但实际上全局安装方式更常用,此处command填写 'devvit-phaser-mcp' 更通用,如果用户从仓库启动,可以填写 'npm' 作为 command,'run start:mcp' 作为 args)。
  • 'args': 启动命令的参数,本服务器默认通过 stdio 启动,无需额外参数,因此为空数组 '[]'。
  • 'protocol': 通信协议,本服务器使用 'stdio'。
  • 'description': 服务器的描述信息,可以自定义。
  • 'capabilities': 声明服务器提供的能力,包括 'resources' 和 'tools',均为空对象 '{}',表示支持所有资源和工具能力。

基本使用方法

  1. 启动 MCP 服务器:

    • 全局安装方式:在终端中运行 'devvit-phaser-mcp' 命令。
    • 从仓库安装方式:在仓库根目录下运行 'npm run start:mcp' 命令。
    • 可以使用 '--help' 参数查看更多启动选项,例如 'devvit-phaser-mcp --help'。
  2. 使用 MCP 客户端连接服务器:

    • 配置 MCP 客户端,填入上述服务器配置信息。
    • 客户端连接成功后,即可通过 MCP 协议调用服务器提供的 Resources 和 Tools,例如:
      • 使用 'browser-launch' Tool 启动浏览器。
      • 使用 'browser-navigate' Tool 打开 Devvit-Phaser 游戏页面。
      • 使用 'playtest-status' Resource 获取 Playtest 状态。
      • 详细的 Resources 和 Tools 使用方法请参考仓库 'mcp/README.md' 文件。

注意:

  • 此 MCP 服务器主要用于 测试 Devvit-Phaser 游戏,而非生产环境。
  • 服务器通过 stdio 与 MCP 客户端通信。

信息

分类

开发者工具