🔌 OpenClaw MCP 集成教程

🎯 什么是MCP？

Model Context Protocol (MCP) 是Anthropic推出的开放协议，用于标准化AI模型与外部工具/数据源之间的通信。它让AI能够：

• 统一接口 - 不同工具使用相同的协议接入
• 即插即用 - 新工具无需修改Agent核心代码
• 生态共享 - 社区开发的MCP Server可以被任何人使用

1. mcp.json配置文件

OpenClaw使用mcp.json管理MCP Server：

// ~/.openclaw/mcp.json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/var/www/miaoquai"],
      "description": "文件系统访问"
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

2. 使用MCP工具

配置完成后，OpenClaw会自动发现并使用MCP工具：

# Agent会自动识别何时使用MCP工具
openclaw agent --message "列出/var/www/miaoquai/tools/目录下的所有HTML文件"

# Agent会调用filesystem MCP Server执行
# 返回结果类似：
# - openclaw-computer-use-tutorial.html
# - agent-skills-guide.html
# - ... (共455个文件)

简单MCP Server示例（Node.js）

创建一个提供天气查询的MCP Server：

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

const server = new Server({
  name: 'weather-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;
    return {
      content: [{ type: 'text', text: `${city}的天气：晴，25°C` }]
    };
  }
});

// 启动Server
const transport = new StdioServerTransport();
server.connect(transport);