xiaowan 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ocean
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,234 @@
+# Claw Xiaowan - MCP Server Plugin for OpenClaw
+
+OpenClaw plugin for integrating MCP (Model Context Protocol) servers as agent tools.
+
+## Features
+
+- Connect to multiple MCP servers simultaneously
+- Register MCP tools as native OpenClaw agent tools
+- Support for multiple transport types:
+  - **Stdio** - Local MCP servers and npx commands
+  - **SSE** - Server-Sent Events over HTTP/HTTPS
+  - **Streamable HTTP** - HTTP with streaming support and Bearer auth
+- Connection status monitoring with health checks
+- CLI commands for server management
+- Gateway RPC methods for status queries
+
+## Installation
+
+### From npm
+
+```bash
+openclaw plugins install claw-xiaowan
+openclaw gateway restart
+```
+
+### Local Development
+
+```bash
+# Clone the repository
+git clone https://github.com/y-shi23/OmniClawPlugin.git
+cd OmniClawPlugin
+
+# Install dependencies
+npm install
+
+# Build the plugin
+npm run build
+
+# Link this plugin to your OpenClaw extensions
+openclaw plugins install -l /path/to/OmniClawPlugin
+
+# Restart the gateway
+openclaw gateway restart
+```
+
+## Configuration
+
+Add to your OpenClaw config file:
+
+```json5
+{
+  plugins: {
+    entries: {
+      "xiaowan": {
+        enabled: true,
+        config: {
+          servers: [
+            {
+              id: "filesystem",
+              name: "Filesystem Tools",
+              url: "npx -y @modelcontextprotocol/server-filesystem /tmp",
+              enabled: true
+            },
+            {
+              id: "git",
+              name: "Git Operations",
+              url: "npx -y @modelcontextprotocol/server-git /path/to/repo",
+              enabled: true
+            },
+            {
+              id: "my-sse-server",
+              name: "My SSE Server",
+              url: "http://localhost:3000/sse",
+              enabled: true
+            },
+            {
+              id: "my-http-server",
+              name: "My HTTP Server",
+              url: "https://api.example.com/mcp",
+              type: "streamablehttp",
+              token: "your-bearer-token",
+              enabled: true
+            }
+          ]
+        }
+      }
+    }
+  }
+}
+```
+
+## Server Configuration
+
+### Transport Types
+
+The plugin automatically detects the transport type based on the URL or explicit `type` field:
+
+| Type | URL Pattern | Description |
+|------|-------------|-------------|
+| **Stdio** | Any non-HTTP URL | Local executables and npx commands |
+| **SSE** | `http://` or `https://` | Server-Sent Events transport |
+| **Streamable HTTP** | Explicit `type: "streamablehttp"` | HTTP with Bearer auth and streaming |
+
+### Server Properties
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `id` | string | Yes | Unique identifier for the server |
+| `name` | string | No | Display name (defaults to `id`) |
+| `url` | string | Yes | Server URL or command |
+| `type` | string | No | Transport type (`streamablehttp`, others auto-detected) |
+| `token` | string | No | Auth token for Bearer authentication |
+| `enabled` | boolean | No | Enable/disable server (default: `true`) |
+
+### Transport Examples
+
+**Stdio (Local MCP Server)**
+```json
+{
+  "id": "filesystem",
+  "url": "npx -y @modelcontextprotocol/server-filesystem /tmp"
+}
+```
+
+**SSE (Server-Sent Events)**
+```json
+{
+  "id": "my-server",
+  "url": "http://localhost:3000/sse"
+}
+```
+
+**Streamable HTTP with Bearer Auth**
+```json
+{
+  "id": "my-http-server",
+  "url": "https://api.example.com/mcp",
+  "type": "streamablehttp",
+  "token": "your-bearer-token"
+}
+```
+
+## Usage
+
+### CLI Commands
+
+```bash
+# List configured MCP servers
+openclaw mcp --list
+
+# Check server status
+openclaw mcp --status
+```
+
+### Agent Tools
+
+Once configured, MCP tools are available to OpenClaw agents. Tools are automatically named using the pattern:
+
+```
+mcp_<server-id>_<tool-name>
+```
+
+For example:
+- `filesystem` server with `read_file` tool → `mcp_filesystem_read_file`
+- `git` server with `clone` tool → `mcp_git_clone`
+
+Tool names are sanitized (lowercased, special characters replaced with underscores).
+
+### Gateway RPC
+
+```bash
+# Get MCP server status via RPC
+openclaw gateway rpc mcp.status
+```
+
+Returns:
+```json
+{
+  "ok": true,
+  "servers": [
+    {
+      "id": "filesystem",
+      "name": "Filesystem Tools",
+      "enabled": true,
+      "url": "npx -y @modelcontextprotocol/server-filesystem /tmp",
+      "connected": true
+    }
+  ]
+}
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build the plugin
+npm run build
+
+# Watch for changes during development
+npm run dev
+
+# Pack for npm publishing
+npm pack
+```
+
+## Supported MCP Servers
+
+This plugin works with any MCP-compliant server. Official examples:
+
+- `@modelcontextprotocol/server-filesystem` - Filesystem operations
+- `@modelcontextprotocol/server-git` - Git operations
+- `@modelcontextprotocol/server-brave-search` - Brave search integration
+- `@modelcontextprotocol/server-postgres` - PostgreSQL database access
+- Custom MCP servers
+
+## Architecture
+
+The plugin consists of three main components:
+
+1. **McpClientManager** - Manages connections to MCP servers with support for multiple transports
+2. **ToolRegistrar** - Registers MCP tools as OpenClaw agent tools
+3. **McpPlugin** - Main plugin class that wires everything together
+
+## License
+
+MIT
+
+## Links
+
+- [Repository](https://github.com/y-shi23/OmniClawPlugin)
+- [Issues](https://github.com/y-shi23/OmniClawPlugin/issues)
+- [MCP Specification](https://modelcontextprotocol.io/)

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { McpPlugin } from "./mcp-plugin.js";
+/**
+ * MCP Server Plugin for OpenClaw
+ *
+ * This plugin integrates MCP (Model Context Protocol) servers as OpenClaw agent tools.
+ * It allows OpenClaw agents to call MCP tools as if they were native tools.
+ */
+export default function register(api: any): void;
+export { McpPlugin };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,QAGxC;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+import { McpPlugin } from "./mcp-plugin.js";
+/**
+ * MCP Server Plugin for OpenClaw
+ *
+ * This plugin integrates MCP (Model Context Protocol) servers as OpenClaw agent tools.
+ * It allows OpenClaw agents to call MCP tools as if they were native tools.
+ */
+export default function register(api) {
+    const plugin = new McpPlugin(api);
+    plugin.register();
+}
+export { McpPlugin };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAQ;IACvC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,CAAC,QAAQ,EAAE,CAAC;AACpB,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/mcp-client.d.ts

@@ -0,0 +1,38 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+/**
+ * MCP Client Manager
+ *
+ * Manages connections to multiple MCP servers
+ */
+export declare class McpClientManager {
+    private api;
+    private clients;
+    private transports;
+    constructor(api: any);
+    /**
+     * Connect to an MCP server
+     */
+    connect(serverConfig: any): Promise<Client>;
+    /**
+     * Disconnect from an MCP server
+     */
+    disconnect(serverId: string): Promise<void>;
+    /**
+     * Check if a server is connected
+     */
+    isConnected(serverId: string): Promise<boolean>;
+    /**
+     * Get a client by server ID
+     */
+    getClient(serverId: string): Client | undefined;
+    /**
+     * Disconnect all servers
+     */
+    disconnectAll(): Promise<void>;
+    /**
+     * Create WebSocket transport (custom implementation)
+     * Note: This is a placeholder - actual WebSocket transport implementation may vary
+     */
+    private createWebSocketTransport;
+}
+//# sourceMappingURL=mcp-client.d.ts.map

package/dist/mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../src/mcp-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE;;;;GAIG;AACH,qBAAa,gBAAgB;IAIf,OAAO,CAAC,GAAG;IAHvB,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,UAAU,CAA+B;gBAE7B,GAAG,EAAE,GAAG;IAE5B;;OAEG;IACG,OAAO,CAAC,YAAY,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IA+DjD;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBjD;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAarD;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI/C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAKpC;;;OAGG;YACW,wBAAwB;CAMvC"}

package/dist/mcp-client.js

@@ -0,0 +1,138 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+/**
+ * MCP Client Manager
+ *
+ * Manages connections to multiple MCP servers
+ */
+export class McpClientManager {
+    api;
+    clients = new Map();
+    transports = new Map();
+    constructor(api) {
+        this.api = api;
+    }
+    /**
+     * Connect to an MCP server
+     */
+    async connect(serverConfig) {
+        const { id, url, token, type } = serverConfig;
+        // Check if already connected
+        if (this.clients.has(id)) {
+            const existingClient = this.clients.get(id);
+            if (await this.isConnected(id)) {
+                return existingClient;
+            }
+            // Clean up disconnected client
+            await this.disconnect(id);
+        }
+        // Create new client
+        const client = new Client({
+            name: `openclaw-mcp-${id}`,
+            version: "1.0.0",
+        }, {
+            capabilities: {},
+        });
+        // Create transport based on URL scheme or type
+        let transport;
+        if (type === "streamablehttp") {
+            // Streamable HTTP transport with Bearer auth
+            transport = new StreamableHTTPClientTransport(new URL(url), {
+                requestInit: {
+                    headers: {
+                        "Authorization": `Bearer ${token}`,
+                        "Content-Type": "application/json"
+                    }
+                }
+            });
+        }
+        else if (url.startsWith("http://") || url.startsWith("https://")) {
+            // SSE transport
+            transport = new SSEClientTransport(new URL(url));
+        }
+        else if (url.startsWith("ws://") || url.startsWith("wss://")) {
+            // WebSocket transport (requires custom implementation)
+            transport = await this.createWebSocketTransport(url, token);
+        }
+        else {
+            // Assume stdio transport for local executables
+            transport = new StdioClientTransport({
+                command: url,
+                args: token ? ["--token", token] : [],
+            });
+        }
+        this.transports.set(id, transport);
+        // Connect
+        await client.connect(transport);
+        this.clients.set(id, client);
+        this.api.logger.info(`Connected to MCP server: ${id}`);
+        return client;
+    }
+    /**
+     * Disconnect from an MCP server
+     */
+    async disconnect(serverId) {
+        const client = this.clients.get(serverId);
+        if (client) {
+            try {
+                await client.close();
+            }
+            catch (e) {
+                this.api.logger.warn(`Error closing MCP client ${serverId}:`, e);
+            }
+            this.clients.delete(serverId);
+        }
+        const transport = this.transports.get(serverId);
+        if (transport) {
+            try {
+                await transport.close();
+            }
+            catch (e) {
+                this.api.logger.warn(`Error closing MCP transport ${serverId}:`, e);
+            }
+            this.transports.delete(serverId);
+        }
+    }
+    /**
+     * Check if a server is connected
+     */
+    async isConnected(serverId) {
+        const client = this.clients.get(serverId);
+        if (!client)
+            return false;
+        try {
+            // Try to ping the server
+            const response = await client.ping();
+            return !!response;
+        }
+        catch (e) {
+            return false;
+        }
+    }
+    /**
+     * Get a client by server ID
+     */
+    getClient(serverId) {
+        return this.clients.get(serverId);
+    }
+    /**
+     * Disconnect all servers
+     */
+    async disconnectAll() {
+        const serverIds = Array.from(this.clients.keys());
+        await Promise.all(serverIds.map((id) => this.disconnect(id)));
+    }
+    /**
+     * Create WebSocket transport (custom implementation)
+     * Note: This is a placeholder - actual WebSocket transport implementation may vary
+     */
+    async createWebSocketTransport(url, token) {
+        // TODO: Implement WebSocket transport
+        // The MCP SDK may not have built-in WebSocket support yet
+        // This would require a custom transport implementation
+        throw new Error("WebSocket transport not yet implemented. Use SSE or stdio.");
+    }
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/mcp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.js","sourceRoot":"","sources":["../src/mcp-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAEnG;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IAIP;IAHZ,OAAO,GAAwB,IAAI,GAAG,EAAE,CAAC;IACzC,UAAU,GAAqB,IAAI,GAAG,EAAE,CAAC;IAEjD,YAAoB,GAAQ;QAAR,QAAG,GAAH,GAAG,CAAK;IAAG,CAAC;IAEhC;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,YAAiB;QAC7B,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,YAAY,CAAC;QAE9C,6BAA6B;QAC7B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACzB,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC;YAC7C,IAAI,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC/B,OAAO,cAAc,CAAC;YACxB,CAAC;YACD,+BAA+B;YAC/B,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC;QAED,oBAAoB;QACpB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;YACE,IAAI,EAAE,gBAAgB,EAAE,EAAE;YAC1B,OAAO,EAAE,OAAO;SACjB,EACD;YACE,YAAY,EAAE,EAAE;SACjB,CACF,CAAC;QAEF,+CAA+C;QAC/C,IAAI,SAAS,CAAC;QACd,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;YAC9B,6CAA6C;YAC7C,SAAS,GAAG,IAAI,6BAA6B,CAC3C,IAAI,GAAG,CAAC,GAAG,CAAC,EACZ;gBACE,WAAW,EAAE;oBACX,OAAO,EAAE;wBACP,eAAe,EAAE,UAAU,KAAK,EAAE;wBAClC,cAAc,EAAE,kBAAkB;qBACnC;iBACF;aACF,CACF,CAAC;QACJ,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACnE,gBAAgB;YAChB,SAAS,GAAG,IAAI,kBAAkB,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACnD,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/D,uDAAuD;YACvD,SAAS,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,+CAA+C;YAC/C,SAAS,GAAG,IAAI,oBAAoB,CAAC;gBACnC,OAAO,EAAE,GAAG;gBACZ,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;aACtC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAEnC,UAAU;QACV,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAE7B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;YAC1B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC;YACtE,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,QAAgB;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAE1B,IAAI,CAAC;YACH,yBAAyB;YACzB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACrC,OAAO,CAAC,CAAC,QAAQ,CAAC;QACpB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,wBAAwB,CAAC,GAAW,EAAE,KAAc;QAChE,sCAAsC;QACtC,0DAA0D;QAC1D,uDAAuD;QACvD,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;CACF"}

package/dist/mcp-plugin.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Main MCP Plugin class
+ *
+ * Manages MCP client connections and tool registration with OpenClaw
+ */
+export declare class McpPlugin {
+    private api;
+    private clientManager;
+    private toolRegistrar;
+    constructor(api: any);
+    register(): void;
+    private getStatus;
+    private listServers;
+    private showStatus;
+}
+//# sourceMappingURL=mcp-plugin.d.ts.map

package/dist/mcp-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-plugin.d.ts","sourceRoot":"","sources":["../src/mcp-plugin.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,qBAAa,SAAS;IAIR,OAAO,CAAC,GAAG;IAHvB,OAAO,CAAC,aAAa,CAAmB;IACxC,OAAO,CAAC,aAAa,CAAgB;gBAEjB,GAAG,EAAE,GAAG;IAK5B,QAAQ;YA+BM,SAAS;YAgBT,WAAW;YAYX,UAAU;CAOzB"}

package/dist/mcp-plugin.js

@@ -0,0 +1,79 @@
+import { McpClientManager } from "./mcp-client.js";
+import { ToolRegistrar } from "./tools.js";
+/**
+ * Main MCP Plugin class
+ *
+ * Manages MCP client connections and tool registration with OpenClaw
+ */
+export class McpPlugin {
+    api;
+    clientManager;
+    toolRegistrar;
+    constructor(api) {
+        this.api = api;
+        this.clientManager = new McpClientManager(api);
+        this.toolRegistrar = new ToolRegistrar(api, this.clientManager);
+    }
+    register() {
+        // Register all MCP servers as tools
+        this.toolRegistrar.registerTools();
+        // Register gateway RPC method for status
+        this.api.registerGatewayMethod("mcp.status", async ({ respond }) => {
+            const status = await this.getStatus();
+            respond(true, status);
+        });
+        // Register CLI commands
+        this.api.registerCli(({ program }) => {
+            program
+                .command("mcp")
+                .description("Manage MCP servers")
+                .option("--list", "List configured MCP servers")
+                .option("--status", "Show MCP server status")
+                .action(async (options) => {
+                if (options.list) {
+                    await this.listServers();
+                }
+                else if (options.status) {
+                    await this.showStatus();
+                }
+                else {
+                    console.log("Use --list or --status");
+                }
+            });
+        }, { commands: ["mcp"] });
+        this.api.logger.info("MCP Server plugin registered");
+    }
+    async getStatus() {
+        const config = this.api.config.plugins?.entries?.["xiaowan"]?.config || {};
+        const servers = config.servers || [];
+        return {
+            ok: true,
+            servers: servers.map((server) => ({
+                id: server.id,
+                name: server.name || server.id,
+                enabled: server.enabled !== false,
+                url: server.url,
+                connected: this.clientManager.isConnected(server.id),
+            })),
+        };
+    }
+    async listServers() {
+        const status = await this.getStatus();
+        console.log("\n=== MCP Servers ===");
+        status.servers.forEach((server) => {
+            const icon = server.enabled ? "✓" : "✗";
+            const conn = server.connected ? "connected" : "disconnected";
+            console.log(`${icon} ${server.name} (${server.id}) - ${conn}`);
+            console.log(`   URL: ${server.url}`);
+        });
+        console.log();
+    }
+    async showStatus() {
+        const status = await this.getStatus();
+        console.log("\n=== MCP Status ===");
+        console.log(`Total servers: ${status.servers.length}`);
+        console.log(`Connected: ${status.servers.filter((s) => s.connected).length}`);
+        console.log();
+    }
+}
+//# sourceMappingURL=mcp-plugin.js.map

package/dist/mcp-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-plugin.js","sourceRoot":"","sources":["../src/mcp-plugin.ts"],"names":[],"mappings":"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"}

package/dist/tools.d.ts

@@ -0,0 +1,28 @@
+import { McpClientManager } from "./mcp-client.js";
+/**
+ * Tool Registrar
+ *
+ * Registers MCP tools as OpenClaw agent tools
+ */
+export declare class ToolRegistrar {
+    private api;
+    private clientManager;
+    constructor(api: any, clientManager: McpClientManager);
+    /**
+     * Register all configured MCP servers as tools
+     */
+    registerTools(): Promise<void>;
+    /**
+     * Register tools from a single MCP server
+     */
+    private registerServerTools;
+    /**
+     * Register a single MCP tool as an OpenClaw tool
+     */
+    private registerMcpTool;
+    /**
+     * Sanitize tool name to be valid identifier
+     */
+    private sanitizeToolName;
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;GAIG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,aAAa;gBADb,GAAG,EAAE,GAAG,EACR,aAAa,EAAE,gBAAgB;IAGzC;;OAEG;IACG,aAAa;IAiBnB;;OAEG;YACW,mBAAmB;IAajC;;OAEG;IACH,OAAO,CAAC,eAAe;IAuCvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/tools.js

@@ -0,0 +1,91 @@
+/**
+ * Tool Registrar
+ *
+ * Registers MCP tools as OpenClaw agent tools
+ */
+export class ToolRegistrar {
+    api;
+    clientManager;
+    constructor(api, clientManager) {
+        this.api = api;
+        this.clientManager = clientManager;
+    }
+    /**
+     * Register all configured MCP servers as tools
+     */
+    async registerTools() {
+        const config = this.api.config.plugins?.entries?.["xiaowan"]?.config || {};
+        const servers = config.servers || [];
+        for (const server of servers) {
+            if (server.enabled === false) {
+                continue;
+            }
+            try {
+                await this.registerServerTools(server);
+            }
+            catch (e) {
+                this.api.logger.error(`Failed to register tools for MCP server ${server.id}:`, e);
+            }
+        }
+    }
+    /**
+     * Register tools from a single MCP server
+     */
+    async registerServerTools(server) {
+        const client = await this.clientManager.connect(server);
+        // List available tools from the MCP server
+        const toolsResponse = await client.listTools();
+        for (const mcpTool of toolsResponse.tools) {
+            this.registerMcpTool(server, client, mcpTool);
+        }
+        this.api.logger.info(`Registered ${toolsResponse.tools.length} tools from MCP server: ${server.id}`);
+    }
+    /**
+     * Register a single MCP tool as an OpenClaw tool
+     */
+    registerMcpTool(server, client, mcpTool) {
+        const toolId = `mcp_${server.id}_${mcpTool.name}`;
+        const toolName = this.sanitizeToolName(mcpTool.name);
+        const tool = {
+            name: toolName,
+            description: mcpTool.description || `MCP tool: ${mcpTool.name} from ${server.name || server.id}`,
+            inputSchema: mcpTool.inputSchema,
+            handler: async (params) => {
+                try {
+                    // Ensure client is connected
+                    if (!(await this.clientManager.isConnected(server.id))) {
+                        await this.clientManager.connect(server);
+                    }
+                    // Call the MCP tool
+                    const response = await client.callTool({
+                        name: mcpTool.name,
+                        arguments: params,
+                    });
+                    // Format the response for OpenClaw
+                    return {
+                        content: response.content,
+                        isError: response.isError,
+                    };
+                }
+                catch (e) {
+                    this.api.logger.error(`Error calling MCP tool ${toolName}:`, e);
+                    throw e;
+                }
+            },
+        };
+        // Register the tool with OpenClaw
+        this.api.registerTool(tool);
+        this.api.logger.debug(`Registered tool: ${toolName}`);
+    }
+    /**
+     * Sanitize tool name to be valid identifier
+     */
+    sanitizeToolName(name) {
+        return name
+            .toLowerCase()
+            .replace(/[^a-z0-9_]/g, "_")
+            .replace(/_{2,}/g, "_")
+            .replace(/^_|_$/g, "");
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "xiaowan",
+  "version": "0.1.0",
+  "description": "OpenClaw plugin for MCP (Model Context Protocol) server integration",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepack": "npm run build"
+  },
+  "openclaw": {
+    "extensions": ["./src/index.ts"]
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "openclaw": "latest",
+    "typescript": "^5.0.0"
+  },
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "mcp",
+    "model-context-protocol",
+    "mcp-server"
+  ],
+  "author": "y-shi23 <https://github.com/y-shi23>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/y-shi23/OmniClawPlugin.git"
+  },
+  "homepage": "https://github.com/y-shi23/OmniClawPlugin#readme",
+  "bugs": {
+    "url": "https://github.com/y-shi23/OmniClawPlugin/issues"
+  }
+}