OmniClaw MCP Server Plugin

OpenClaw plugin for integrating MCP (Model Context Protocol) servers as agent tools.

Features

• Connect to multiple MCP servers
• Register MCP tools as native OpenClaw agent tools
• Configuration-based server management
• Connection status monitoring
• CLI commands for server management

Installation

Local Development

# Link this plugin to your OpenClaw extensions
openclaw plugins install -l /Users/ocean/code/OmniClawPlugin

# Restart the gateway
openclaw gateway restart

From npm (when published)

openclaw plugins install @omniclaw/mcp-server
openclaw gateway restart

Configuration

Add to your OpenClaw config:

{
  plugins: {
    entries: {
      "mcp-server": {
        enabled: true,
        config: {
          servers: [
            {
              id: "filesystem",
              name: "Filesystem Tools",
              url: "npx -y @modelcontextprotocol/server-filesystem /tmp",
              enabled: true
            },
            {
              id: "my-custom-server",
              name: "My Custom Server",
              url: "http://localhost:3000/sse",
              token: "your-auth-token",
              enabled: true
            }
          ]
        }
      }
    }
  }
}

Server URL Schemes

The plugin supports different connection methods based on the URL:

• Local executable: npx -y @modelcontextprotocol/server-filesystem /tmp
• HTTP/SSE: http://localhost:3000/sse or https://api.example.com/mcp
• WebSocket: ws://localhost:3000/ws or wss://api.example.com/ws

Usage

CLI Commands

# List configured MCP servers
openclaw mcp --list

# Check server status
openclaw mcp --status

Agent Tools

Once configured, MCP tools are available to OpenClaw agents as:

mcp_<server-id>_<tool-name>

For example, if you have a filesystem server with a read_file tool, agents can call:

mcp_filesystem_read_file

Gateway RPC

# Get MCP server status via RPC
openclaw gateway rpc mcp.status

Development

# Install dependencies
npm install

# Build the plugin
npm run build

# Watch for changes
npm run dev

Supported MCP Servers

This plugin should work with any MCP-compliant server. Known examples:

• @modelcontextprotocol/server-filesystem - Filesystem operations
• @modelcontextprotocol/server-git - Git operations
• Custom MCP servers

License

MIT