项目简介

'mew-protocol' 是一个多实体工作区协议，旨在让AI智能体和人类在共享环境中协作。它包含用于连接、管理和与MCP（Model Context Protocol）服务器交互的组件。其中，猫咪迷宫MCP服务器是该项目提供的一个基于MCP协议的独立应用，它模拟一个有趣的迷宫游戏，AI智能体可以通过调用其提供的工具来控制猫咪在迷宫中移动，寻找出口。

主要功能点

迷宫游戏托管: 运行一个具有多层渐进式难度迷宫的游戏后端。
AI可调用工具: 提供 'view'（查看当前迷宫状态和提示）、'up'、'down'、'left'、'right'（控制猫咪向上、下、左、右移动一格）、'restart'（重新开始冒险）等工具，供AI智能体通过JSON-RPC协议调用。
状态同步: 智能体可以随时获取当前迷宫的布局、猫咪的当前位置、目标位置、已进行的步数、当前所处的关卡信息，以及整个冒险的完成情况。
事件通知: 游戏的重要进展（如猫咪移动、完成关卡、完成整个冒险）会以MCP通知的形式发送给所有连接的参与者，以便智能体实时感知游戏状态变化。

安装步骤

安装 Node.js: 请确保您的系统已安装 Node.js (推荐 v22 及以上版本)。
全局安装 MEW CLI 工具: 打开您的终端或命令行工具，运行以下命令：
```
npm install -g @mew-protocol/mew
```
这将把 'mew-protocol' 的命令行接口 ('mew' 命令) 安装到您的系统路径中。

服务器配置

MCP客户端（例如 'mew-protocol' 提供的 'MCPBridge' 或其他兼容MCP的AI智能体）需要配置猫咪迷宫MCP服务器的启动命令及其参数才能与其建立连接。

以下是 MCP客户端中 'mcpServer' 配置选项的示例 JSON 格式：

{
  "command": "mew",
  "args": ["mcp", "cat-maze"],
  "env": {
    // 可选：在这里添加任何环境变量。
    // 例如，设置 DEBUG 环境变量可以开启更详细的日志输出：
    // "DEBUG": "mew:bridge,mew:mcp-client,mew:server"
  }
}

'command': 'mew' - 这是您通过 npm 全局安装的 'mew-protocol' 命令行工具的执行名称。
'args': '["mcp", "cat-maze"]' - 这是传递给 'mew' 命令的子命令和参数。'mcp' 指示要运行一个内置的MCP服务器，而 'cat-maze' 则指定了要启动的服务器是猫咪迷宫游戏服务器。
'env': (可选) - 这是一个 JSON 对象，包含键值对形式的环境变量。这些变量将会在启动猫咪迷宫MCP服务器进程时被设置。

基本使用方法

启动猫咪迷宫MCP服务器: 打开您的终端或命令行工具，运行以下命令：
```
mew mcp cat-maze
```
此命令将启动猫咪迷宫MCP服务器。它将通过标准输入输出（stdio）等待来自MCP客户端的 JSON-RPC 请求，并在终端中显示其内部日志和状态信息。
连接并与服务器交互 (使用 MEW-MCP 桥接功能): 在另一个终端窗口中，您可以使用 'mew-protocol' 提供的MCP桥接命令行工具，将猫咪迷宫服务器连接到一个 MEW 空间。这样，任何连接到该 MEW 空间的 AI 智能体或客户端都可以与猫咪迷宫服务器交互。

以下是启动一个 MEW-MCP 桥接的示例命令：
```
mew bridge start \
  --gateway ws://localhost:8080 \
  --space my-cat-maze-space \
  --participant-id my-maze-player \
  --token my-secret-token \
  --mcp-command mew \
  --mcp-args "mcp,cat-maze"
```
- '--gateway': MEW 网关的 WebSocket URL。
- '--space': 要加入的 MEW 空间 ID。
- '--participant-id': 桥接在 MEW 空间中的唯一参与者 ID。
- '--token': 用于认证的令牌。
- '--mcp-command' 和 '--mcp-args': 这些参数指示桥接如何启动和管理猫咪迷宫MCP服务器。
一旦桥接成功，您就可以在 'my-cat-maze-space' MEW 空间内，通过 'my-maze-player' 这个参与者，调用猫咪迷宫MCP服务器提供的工具。例如，您可以使用 'mew' 命令行工具连接到 'my-cat-maze-space' 空间，并发送聊天消息让 AI 智能体调用工具：
- 查看当前迷宫: 可以在连接到 'my-cat-maze-space' 的 'mew' 交互式客户端中，指示 AI 智能体调用 'view' 工具。
- 移动猫咪: 智能体可以调用 'up', 'down', 'left', 'right' 等工具来控制猫咪移动。
- 重新开始: 智能体可以调用 'restart' 工具来重新开始迷宫冒险。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息