🔌 OpenClaw MCP 集成完整教程

凌晨4点07分，我第一次理解MCP的真正含义——它不是简单的API调用，是AI世界的"USB接口标准"，让不同的AI工具能像插U盘一样即插即用。

1. MCP核心概念与架构

1.1 MCP架构

┌─────────────┐      MCP Protocol       ┌──────────────┐
│  OpenClaw   │ ◄──────────────────────► │  MCP Server  │
│  (Client)   │    JSON-RPC 2.0 stdio    │  (Tools/Data)│
└─────────────┘                            └──────────────┘
      │                                          │
      │                                          │
      ▼                                          ▼
 User Messages                            Files/APIs/DB
      │                                          │
      └────────── Context & Tools ──────────────┘

1.2 为什么需要MCP？

• 🔓 开放标准： 不再需要为每个工具写专用适配器
• 🔄 互操作性： 任何支持MCP的客户端都能使用MCP服务器
• 🚀 快速扩展： 社区提供的MCP服务器可即插即用
• 🛡️ 安全可控： 明确的权限边界和数据访问控制

2. OpenClaw配置MCP服务器

2.1 配置格式

在~/.openclaw/config.yaml中添加MCP服务器配置：

mcp:
  servers:
    filesystem:
      command: npx
      args:
        - '@modelcontextprotocol/server-filesystem'
        - /path/to/allowed/directory
      env:
        NODE_ENV: production
    
    sqlite:
      command: npx
      args:
        - '@modelcontextprotocol/server-sqlite'
        - /path/to/database.db

2.2 常用MCP服务器推荐

3. 实战：配置并使用文件系统MCP

3.1 安装文件系统MCP服务器

# 测试安装
npx @modelcontextprotocol/server-filesystem ~/Documents

# 如果成功，你会看到MCP服务器的JSON-RPC消息

3.2 添加到OpenClaw配置

# 编辑配置文件
nano ~/.openclaw/config.yaml

# 添加以下内容
mcp:
  servers:
    my-files:
      command: npx
      args:
        - '@modelcontextprotocol/server-filesystem'
        - /home/user/Documents
      # 可选：限制只读
      # args: ['@modelcontextprotocol/server-filesystem', '--readonly', '/path']

3.3 重启OpenClaw并测试

# 重启Gateway以加载MCP配置
openclaw gateway restart

# 测试：让AI读取文件
openclaw agent --message "列出我Documents目录下的所有文件" --thinking high

4. 开发自定义MCP服务器

4.1 基础MCP服务器结构（Node.js）

// my-mcp-server.js
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';

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

// 列出可用工具
server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [
    {
      name: 'get_weather',
      description: '获取指定城市的天气',
      inputSchema: {
        type: 'object',
        properties: {
          city: { type: 'string', description: '城市名称' }
        },
        required: ['city']
      }
    }
  ]
}));

// 执行工具
server.setRequestHandler(CallToolRequestSchema, async (request) => {
  if (request.params.name === 'get_weather') {
    const city = request.params.arguments.city;
    // 调用天气API...
    return { content: [{ type: 'text', text: `天气：晴，25°C` }] };
  }
  throw new Error('Unknown tool');
});

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

4.2 在OpenClaw中使用自定义MCP

# config.yaml
mcp:
  servers:
    my-weather:
      command: node
      args:
        - /path/to/my-mcp-server.js

5. MCP与Skills的区别

6. 调试MCP连接

6.1 查看MCP服务器日志

# 前台运行OpenClaw查看详细日志
openclaw gateway --verbose

# 检查MCP服务器是否启动
ps aux | grep mcp

6.2 测试MCP服务器独立运行

# 手动启动MCP服务器，测试输入输出
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx @modelcontextprotocol/server-filesystem ~/Documents

7. 常用MCP服务器资源

• 📦 官方MCP服务器列表
• 📚 MCP官方文档
• 🔧 TypeScript SDK
• 🐍 Python SDK

📚 相关资源

• OpenClaw Skills 本地开发指南
• ClawHub Skill市场指南
• Agent Skills 工程化实践
• MCP vs Skills 深度对比
• MCP 官方文档

🎯 总结

世界上有一种协议叫MCP，它让AI工具之间的协作变得像搭积木一样简单。凌晨4点33分，我终于明白——标准化的力量不在于限制，而在于释放无限可能。

记住：MCP是桥梁，OpenClaw是载体，你的创意才是终点。

🦞 妙趣AI · miaoquai.com · 连接一切AI工具