MCP 协议参考 (Archive)

Archived original-language source from the legacy CrabClaw docs. This page is intentionally not machine-translated.

Crab Claw 深度集成 Model Context Protocol (MCP)，既作为 MCP 工具消费者（安装外部 MCP 服务），也作为 MCP 工具提供者（输出浏览器自动化工具）。

MCP 服务配置格式

stdio 模式（本地进程）

json

{
  "mcp": {
    "servers": {
      "<server-name>": {
        "command": "<启动命令>",
        "args": ["<参数列表>"],
        "env": {
          "<环境变量>": "<值>"
        }
      }
    }
  }
}
{
  "mcp": {
    "servers": {
      "<server-name>": {
        "command": "<启动命令>",
        "args": ["<参数列表>"],
        "env": {
          "<环境变量>": "<值>"
        }
      }
    }
  }
}

示例：

json

{
  "mcp": {
    "servers": {
      "postgres": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-postgres"],
        "env": { "DATABASE_URL": "postgresql://user:pass@localhost/db" }
      },
      "github": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-github"],
        "env": { "GITHUB_TOKEN": "ghp_xxx" }
      },
      "filesystem": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
      }
    }
  }
}
{
  "mcp": {
    "servers": {
      "postgres": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-postgres"],
        "env": { "DATABASE_URL": "postgresql://user:pass@localhost/db" }
      },
      "github": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-github"],
        "env": { "GITHUB_TOKEN": "ghp_xxx" }
      },
      "filesystem": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
      }
    }
  }
}

远程 MCP 服务

json

{
  "mcp": {
    "remoteServers": {
      "<server-name>": {
        "url": "https://mcp.example.com/v1",
        "apiKey": "<认证密钥>",
        "timeout": 30000
      }
    }
  }
}
{
  "mcp": {
    "remoteServers": {
      "<server-name>": {
        "url": "https://mcp.example.com/v1",
        "apiKey": "<认证密钥>",
        "timeout": 30000
      }
    }
  }
}

浏览器 MCP 工具（18 个）

Crab Claw 输出的浏览器 MCP 工具接口，可被 Claude Desktop、Cursor 等 MCP 客户端调用。

启动方式：

bash

crabclaw browser mcp    # stdio 模式
crabclaw browser mcp    # stdio 模式

工具列表

工具名	参数	返回	说明
`browser_navigate`	`url: string`	截图	导航到 URL
`browser_go_back`	—	—	后退
`browser_go_forward`	—	—	前进
`browser_screenshot`	—	base64 JPEG	页面截图
`browser_get_text`	—	页面文本	提取页面纯文本内容
`browser_snapshot`	—	ARIA 树 JSON	无障碍快照（含 ref 标注）
`browser_click`	`ref: string`	截图	点击 ARIA ref 元素
`browser_fill`	`ref: string, value: string`	截图	填写表单字段
`browser_select`	`ref: string, values: string[]`	截图	选择下拉选项
`browser_hover`	`ref: string`	截图	悬停元素
`browser_type`	`text: string, submit?: bool`	截图	键盘输入
`browser_press_key`	`key: string`	截图	按下特定键
`browser_evaluate`	`script: string`	JS 执行结果	执行 JavaScript
`browser_wait`	`selector?: string, timeout?: int`	成功/超时	等待条件满足
`browser_tab_list`	—	Tab[] JSON	列出标签页
`browser_tab_new`	`url?: string`	Tab JSON	创建标签页
`browser_tab_select`	`index: int`	—	切换标签页
`browser_tab_close`	`index?: int`	—	关闭标签页

接入配置（Claude Desktop 示例）

在 Claude Desktop 的 claude_desktop_config.json 中添加：

json

{
  "mcpServers": {
    "crabclaw-browser": {
      "command": "crabclaw",
      "args": ["browser", "mcp"]
    }
  }
}
{
  "mcpServers": {
    "crabclaw-browser": {
      "command": "crabclaw",
      "args": ["browser", "mcp"]
    }
  }
}

能力树注册协议

MCP 工具安装后自动注册到能力树 dynamic/ 分支：

命名规则

来源	前缀	示例
本地 MCP 插件	`mcp_`	`mcp_postgres_query`
远程 MCP 服务	`remote_`	`remote_api_search`
Argus 视觉工具	`argus_`	`argus_capture_screen`

节点元数据

动态注册的工具节点默认元数据：

字段	默认值	说明
MinTier	`task_write`	最低意图层级
ApprovalType	`plan_confirm`	审批类型
Bindable	`true`	允许技能绑定
SubAgentScope	`""`	主智能体可见
PolicyGroups	`["group:dynamic"]`	策略分组

生命周期事件

事件	触发时机
`mcp.server.started`	MCP 服务启动成功
`mcp.server.stopped`	MCP 服务停止
`mcp.server.error`	MCP 服务启动失败或运行错误
`mcp.tools.registered`	工具注册到能力树完成
`mcp.tools.removed`	工具从能力树移除

CLI 命令参考

bash

crabclaw mcp install <url>         # 从 Git URL 安装
crabclaw mcp import                # 从 Claude Desktop/Cursor/VS Code 导入
crabclaw mcp list                  # 列出已安装服务
crabclaw mcp status <name>         # 查看服务状态
crabclaw mcp start <name>          # 启动服务
crabclaw mcp stop <name>           # 停止服务
crabclaw mcp update <name>         # 更新到最新版
crabclaw mcp uninstall <name>      # 卸载服务
crabclaw mcp install <url>         # 从 Git URL 安装
crabclaw mcp import                # 从 Claude Desktop/Cursor/VS Code 导入
crabclaw mcp list                  # 列出已安装服务
crabclaw mcp status <name>         # 查看服务状态
crabclaw mcp start <name>          # 启动服务
crabclaw mcp stop <name>           # 停止服务
crabclaw mcp update <name>         # 更新到最新版
crabclaw mcp uninstall <name>      # 卸载服务

导入来源

来源	配置路径
Claude Desktop (macOS)	`~/Library/Application Support/Claude/claude_desktop_config.json`
Claude Desktop (Windows)	`%APPDATA%\Claude\claude_desktop_config.json`
Cursor	`.cursor/mcp.json`
VS Code	`.vscode/mcp.json`

内部 MCP 桥接

Crab Claw 内部组件也通过 MCP 协议通信：

组件	协议	说明
oa-coder	JSON-RPC 2.0 stdio	Rust 编辑引擎，9 层模糊匹配
Argus Bridge	MCP IPC	C++/Rust 视觉引擎，5s 握手超时
Browser MCP	stdio 导出	18 个浏览器工具对外输出

相关文档：MCP 自动化指南 · MCP 安装教程 · CLI 命令