🔌 OpenClaw MCP 集成完全指南

Model Context Protocol — 让AI Agent连接万物的标准协议

📋 目录

🤔 什么是MCP？

MCP（Model Context Protocol）是一个开放标准协议，定义了AI Agent如何与外部系统通信。你可以把它理解为"AI Agent的USB接口"——任何支持MCP的系统都可以即插即用地连接到任何支持MCP的Agent。

MCP vs 传统API集成

🏗️ MCP架构

核心组件

通信方式

⚙️ OpenClaw MCP配置

基本配置

# openclaw.yaml 中的MCP配置
mcp:
  servers:
    # 本地MCP服务器（stdio方式）
    filesystem:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-filesystem", "/data"]
      
    # 远程MCP服务器（SSE方式）
    database:
      url: "http://localhost:3001/sse"
      
    # 带认证的远程服务器
    github:
      url: "https://mcp.github.com/sse"
      headers:
        Authorization: "Bearer ${GITHUB_TOKEN}"

高级配置

# 更详细的MCP服务器配置
mcp:
  servers:
    my-server:
      command: "node"
      args: ["./mcp-server.js"]
      env:
        API_KEY: "${MY_API_KEY}"
        DEBUG: "true"
      # 超时配置
      timeout: 30000
      # 重启策略
      restart: true
      maxRestarts: 3

使用wecom_mcp工具调用

// 列出MCP服务器提供的工具
wecom_mcp({
  action: "list",
  category: "doc"      // 文档类工具
})

// 调用MCP工具
wecom_mcp({
  action: "call",
  category: "doc",
  method: "getDoc",
  args: { doc_id: "doxcnxxxxxxxx" }
})

🔥 热门MCP服务器

🛠️ 开发自己的MCP服务器

Node.js示例

// my-mcp-server.js
const { Server } = require('@modelcontextprotocol/sdk/server/index.js');
const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js');

const server = new Server(
  { name: "my-mcp-server", version: "1.0.0" },
  { capabilities: { tools: {} } }
);

// 注册工具
server.setRequestHandler('tools/list', async () => ({
  tools: [
    {
      name: "get_weather",
      description: "获取指定城市的天气信息",
      inputSchema: {
        type: "object",
        properties: {
          city: { type: "string", description: "城市名称" }
        },
        required: ["city"]
      }
    }
  ]
}));

// 处理工具调用
server.setRequestHandler('tools/call', async (request) => {
  if (request.params.name === "get_weather") {
    const city = request.params.arguments.city;
    // 调用天气API
    const weather = await fetchWeather(city);
    return {
      content: [{ type: "text", text: JSON.stringify(weather) }]
    };
  }
});

// 启动服务器
const transport = new StdioServerTransport();
server.connect(transport);

Python示例

# my_mcp_server.py
from mcp.server import Server
from mcp.server.stdio import stdio_server

server = Server("my-mcp-server")

@server.tool()
async def search_database(query: str, limit: int = 10) -> str:
    """搜索数据库中的记录"""
    results = await db.search(query, limit)
    return json.dumps(results)

@server.resource("data://records/{id}")
async def get_record(id: str) -> str:
    """获取指定ID的记录"""
    record = await db.get(id)
    return json.dumps(record)

if __name__ == "__main__":
    stdio_server(server)

🛡️ MCP安全最佳实践

# MCP安全配置示例
mcp:
  servers:
    my-server:
      command: "node"
      args: ["./mcp-server.js"]
      # 安全配置
      security:
        allowedTools: ["get_weather", "search"]  # 白名单
        deniedTools: ["delete_all"]               # 黑名单
        maxCallDuration: 30000                    # 最大调用时间
        requireConfirmation: ["write", "delete"]  # 需要确认的操作

🔥 实战案例

案例：自定义SEO数据MCP服务器

// mcp-seo-server.js - 为OpenClaw提供SEO数据
const server = new Server(
  { name: "seo-mcp-server", version: "1.0.0" },
  { capabilities: { tools: {}, resources: {} } }
);

// 工具：分析页面SEO
server.setRequestHandler('tools/list', async () => ({
  tools: [{
    name: "analyze_seo",
    description: "分析目标URL的SEO指标",
    inputSchema: {
      type: "object",
      properties: {
        url: { type: "string", description: "目标URL" }
      },
      required: ["url"]
    }
  }]
}));

// 资源：SEO报告
server.setRequestHandler('resources/list', async () => ({
  resources: [{
    uri: "seo://reports/latest",
    name: "最新SEO报告",
    mimeType: "application/json"
  }]
}));

// 在openclaw.yaml中配置
// mcp:
//   servers:
//     seo:
//       command: "node"
//       args: ["./mcp-seo-server.js"]