🔌 OpenClaw MCP Server 集成教程

什么是 MCP？

MCP（Model Context Protocol）是一个开放标准，由 Anthropic 提出并维护，允许 AI Agent 通过标准化接口连接外部工具和数据源。OpenClaw 原生支持 MCP，可以无缝集成任何 MCP Server。

MCP 架构

+------------------+     MCP Protocol     +------------------+
|   OpenClaw Agent | <------------------> |   MCP Server     |
|                  |    (stdio/SSE)       |  (工具/数据源)    |
+------------------+                      +------------------+

传输方式

配置 MCP Server

在 OpenClaw 配置文件中添加 MCP Server：

// openclaw.config.js 或配置文件中的 mcpServers 部分
{
  "mcpServers": {
    // stdio 方式 - 本地进程
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    },
    // stdio 方式 - Python 脚本
    "my-tool": {
      "command": "python",
      "args": ["./mcp-server.py"],
      "env": {
        "API_KEY": "your-api-key"
      }
    },
    // SSE 方式 - 远程服务
    "remote-db": {
      "url": "https://mcp.example.com/sse",
      "headers": {
        "Authorization": "Bearer token123"
      }
    }
  }
}

常用 MCP Server

1. 文件系统服务器

{
  "filesystem": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/docs"]
  }
}

提供文件读写、目录浏览、文件搜索能力。

2. 数据库服务器

{
  "postgres": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-postgres"],
    "env": {
      "DATABASE_URL": "postgresql://user:pass@localhost:5432/mydb"
    }
  }
}

3. Web 搜索服务器

{
  "brave-search": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-brave-search"],
    "env": {
      "BRAVE_API_KEY": "your-brave-api-key"
    }
  }
}

4. GitHub 服务器

{
  "github": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
    }
  }
}

5. 自定义 MCP Server

// my-mcp-server.py
import asyncio
from mcp import Server, Tool

server = Server("my-custom-tool")

@server.tool()
async def analyze_data(data: str) -> str:
    """分析数据并返回结果"""
    # 你的业务逻辑
    result = process(data)
    return result

if __name__ == "__main__":
    asyncio.run(server.run())

MCP 工具调用

配置完成后，Agent 可以直接使用 MCP 工具：

// Agent 自动发现并使用 MCP 工具
// 用户："帮我读取 /home/user/report.txt 的内容"
// Agent 会自动调用 filesystem MCP 的 readFile 工具

// 查看可用的 MCP 工具
wecom_mcp({ action: "list", category: "filesystem" })

// 调用 MCP 工具
wecom_mcp({
  action: "call",
  category: "filesystem",
  method: "readFile",
  args: { path: "/home/user/report.txt" }
})

MCP 安全最佳实践

安全清单

1. 最小权限：只授予 MCP Server 必需的权限

   // ❌ 授予整个文件系统权限
   args: ["-y", "@modelcontextprotocol/server-filesystem", "/"]
   
   // ✅ 只授予特定目录权限
   args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/docs"]

2. 环境变量保护：敏感信息使用环境变量，不要硬编码

   // ✅ 使用环境变量
   env: {
     "API_KEY": "${MY_API_KEY}"  // 从环境变量读取
   }

3. 网络隔离：本地 MCP Server 不应暴露网络端口
4. 定期审计：检查 MCP Server 的更新和安全公告
5. 版本锁定：使用特定版本号，避免自动更新引入漏洞

故障排查

常见问题

Q: 可以同时使用多个 MCP Server 吗？

可以。OpenClaw 支持同时连接多个 MCP Server，每个 Server 提供独立的工具集。

Q: MCP Server 的性能影响大吗？

stdio 方式几乎没有额外开销。SSE 方式会有网络延迟，建议对延迟敏感的场景使用本地 Server。

Q: 如何调试 MCP Server？

# 查看 MCP 通信日志
openclaw --debug mcp

# 测试单个 MCP Server
npx @modelcontextprotocol/inspector your-server