🔌 OpenClaw MCP 生态系统完全指南

# 列出可用的 MCP 服务器
openclaw mcp list

# 连接到一个 MCP 服务器
openclaw mcp connect filesystem

# 查看服务器提供的工具
openclaw mcp tools filesystem

// 在 Skill 中使用 MCP 工具
const { Skill } = require('@openclaw/core');

class MCPEnabledSkill extends Skill {
  async init() {
    // 获取 MCP 客户端
    this.mcp = this.getMCPClient('filesystem');
  }

  async execute(options) {
    // 调用 MCP 工具
    const files = await this.mcp.callTool('list_files', {
      path: options.path
    });
    
    return files;
  }
}

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

// 创建服务器
const server = new Server({
  name: "my-custom-mcp",
  version: "1.0.0"
}, {
  capabilities: {
    tools: {}
  }
});

// 定义工具
server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
    tools: [
      {
        name: "echo",
        description: "回显输入的文本",
        inputSchema: {
          type: "object",
          properties: {
            text: { type: "string" }
          },
          required: ["text"]
        }
      }
    ]
  };
});

// 实现工具
server.setRequestHandler(CallToolRequestSchema, async (request) => {
  if (request.params.name === "echo") {
    return {
      content: [{
        type: "text",
        text: request.params.arguments.text
      }]
    };
  }
  throw new Error("Unknown tool");
});

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

# 在 OpenClaw 配置中添加
openclaw config set mcp.servers.my-custom-mcp.command node
openclaw config set mcp.servers.my-custom-mcp.args '["/path/to/server.js"]'

# 重启 OpenClaw
openclaw restart

// 旧代码（有状态）
server.setRequestHandler(InitializeRequestSchema, async (request) => {
  this.sessionId = generateSessionId();
  return { sessionId: this.sessionId };
});

// 新代码（无状态）
server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
  const method = extra.headers['mcp-method'];
  const name = extra.headers['mcp-name'];
  
  // 每个请求独立处理，不保持状态
  return await processRequest(request, { method, name });
});