🔌 OpenClaw MCP协议集成完全指南

📋 MCP是什么？

MCP（Model Context Protocol）是Anthropic提出的开放协议，让AI模型能标准化地访问外部工具和数据源。类比：

• USB：即插即用，统一接口
• HTTP：标准协议，跨平台兼容
• SQL：统一查询语言，数据格式无关

核心优势：一个MCP Server可以被任何支持MCP的AI Client调用，无需重复集成。

🏗️ MCP架构

# MCP通信流程
┌─────────────┐                    ┌─────────────┐
│ MCP Client  │  ←─ JSON-RPC ──→  │ MCP Server  │
│ (OpenClaw)  │     over stdio     │ (GitHub)    │
└─────────────┘                    └─────────────┘

# 1. Client初始化连接
# 2. Server返回工具列表和能力声明
# 3. Client根据任务调用工具
# 4. Server返回执行结果

🚀 OpenClaw中配置MCP

方法1：Gateway配置

# openclaw.yaml - Gateway MCP配置
mcpServers:
  # GitHub MCP Server
  github:
    command: npx
    args: ["-y", "@anthropic/mcp-server-github"]
    env:
      GITHUB_TOKEN: ${GITHUB_TOKEN}

  # 文件系统 MCP Server
  filesystem:
    command: npx
    args: ["-y", "@anthropic/mcp-server-filesystem", "/workspace"]

  # 数据库 MCP Server
  postgres:
    command: npx
    args: ["-y", "@anthropic/mcp-server-postgres", "postgresql://..."]

  # Puppeteer MCP Server（浏览器）
  puppeteer:
    command: npx
    args: ["-y", "@anthropic/mcp-server-puppeteer"]

方法2：动态配置

# 使用OpenClaw CLI动态添加MCP Server
openclaw mcp add github --command "npx" --args "@anthropic/mcp-server-github"
openclaw mcp add filesystem --command "npx" --args "@anthropic/mcp-server-filesystem /data"

# 查看已配置的MCP Server
openclaw mcp list

# 测试MCP Server连接
openclaw mcp test github

🔧 常用MCP Server推荐

💡 实战：GitHub MCP深度使用

# 配置
mcpServers:
  github:
    command: npx
    args: ["-y", "@anthropic/mcp-server-github"]
    env:
      GITHUB_TOKEN: ghp_xxxxxxxxxx

# Agent可直接使用的GitHub工具
# 无需编写任何代码，AI自动调用：

# 搜索仓库
→ "搜索GitHub上关于OpenClaw Skills的仓库，按star排序"

# 管理Issues
→ "创建一个issue，标题是'浏览器自动化偶发超时'，标签加bug和triage"

# PR Review
→ "Review PR #42，检查是否有安全问题和性能瓶颈"

# Discussions运营
→ "列出anthropics/openclaw仓库过去24小时的新讨论，按活跃度排序"

🌐 MCP vs A2A vs 直接集成

🛡️ 安全最佳实践

• 最小权限：MCP Server只授予必要的权限
• 沙箱运行：使用Docker或用户级隔离运行MCP进程
• 审计日志：记录所有MCP工具调用
• Token管理：通过环境变量注入，不硬编码

# 安全配置示例
mcpServers:
  github:
    command: docker
    args: ["run", "--rm", "-i", "gh-mcp-server"]
    env:
      GITHUB_TOKEN: ${GITHUB_TOKEN}  # 从环境变量读取
    # 可选：限制可访问的工具
    allowedTools:
      - search_repositories
      - create_issue
      - list_pull_requests
    # 禁止危险操作
    disabledTools:
      - delete_repository
      - push_files