@agiflowai/clawdbot-mcp-plugin 0.1.0

package/dist/plugin.cjs

@@ -0,0 +1,220 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let __sinclair_typebox = require("@sinclair/typebox");
+__sinclair_typebox = __toESM(__sinclair_typebox);
+let __agiflowai_one_mcp = require("@agiflowai/one-mcp");
+__agiflowai_one_mcp = __toESM(__agiflowai_one_mcp);
+
+//#region src/plugin.ts
+const mcpBridgePlugin = {
+	id: "clawdbot-mcp-plugin",
+	name: "MCP Server Bridge",
+	description: "Enables Model Context Protocol (MCP) server integration with progressive tool disclosure",
+	configSchema: __sinclair_typebox.Type.Object({
+		configFilePath: __sinclair_typebox.Type.Optional(__sinclair_typebox.Type.String({
+			description: "Path to mcp-config.yaml file (supports one-mcp's YAML format)",
+			default: ".clawdbot/mcp-config.yaml"
+		})),
+		serverId: __sinclair_typebox.Type.Optional(__sinclair_typebox.Type.String({
+			description: "Unique identifier for the toolkit",
+			default: "clawdbot-mcp"
+		})),
+		noCache: __sinclair_typebox.Type.Optional(__sinclair_typebox.Type.Boolean({
+			description: "Disable configuration caching",
+			default: false
+		}))
+	}),
+	register(api) {
+		const pluginConfig = api.pluginConfig || {};
+		const serverOptions = {
+			configFilePath: pluginConfig.configFilePath || ".clawdbot/mcp-config.yaml",
+			serverId: pluginConfig.serverId || "clawdbot-mcp",
+			noCache: pluginConfig.noCache || false
+		};
+		let describeToolsToolInstance = null;
+		let useToolToolInstance = null;
+		let isInitialized = false;
+		let toolkitDescription = null;
+		api.registerService({
+			id: "mcp-server",
+			async start() {
+				try {
+					api.logger.info(`[one-mcp] Initializing MCP server with config: ${serverOptions.configFilePath}`);
+					const clientManager = new __agiflowai_one_mcp.McpClientManagerService();
+					const config = await new __agiflowai_one_mcp.ConfigFetcherService({
+						configFilePath: serverOptions.configFilePath,
+						useCache: !serverOptions.noCache
+					}).fetchConfiguration(serverOptions.noCache || false);
+					const connectionPromises = Object.entries(config.mcpServers).map(async ([serverName, serverConfig]) => {
+						try {
+							await clientManager.connectToServer(serverName, serverConfig);
+							api.logger.info(`[one-mcp] Connected to MCP server: ${serverName}`);
+						} catch (error) {
+							const errorMessage = error instanceof Error ? error.message : String(error);
+							api.logger.error(`[one-mcp] Failed to connect to ${serverName}:`, errorMessage);
+						}
+					});
+					await Promise.all(connectionPromises);
+					const skillsConfig = config.skills;
+					const skillService = skillsConfig && skillsConfig.paths.length > 0 ? new __agiflowai_one_mcp.SkillService(process.cwd(), skillsConfig.paths) : void 0;
+					describeToolsToolInstance = new __agiflowai_one_mcp.DescribeToolsTool(clientManager, skillService, serverOptions.serverId);
+					useToolToolInstance = new __agiflowai_one_mcp.UseToolTool(clientManager, skillService, serverOptions.serverId);
+					toolkitDescription = (await describeToolsToolInstance.getDefinition()).description;
+					isInitialized = true;
+					api.logger.info("[one-mcp] MCP server initialized successfully");
+				} catch (error) {
+					const errorMessage = error instanceof Error ? error.message : String(error);
+					api.logger.error("[one-mcp] Failed to initialize MCP server:", errorMessage);
+					throw error;
+				}
+			},
+			async stop() {
+				api.logger.info("[one-mcp] MCP server stopping");
+				isInitialized = false;
+				describeToolsToolInstance = null;
+				useToolToolInstance = null;
+			}
+		});
+		api.registerTool({
+			name: "mcp__describe_tools",
+			description: `
+<toolkit id="${serverOptions.serverId}">
+<instruction>
+Before you use any capabilities below, you MUST call this tool with a list of names to learn how to use them properly; this includes:
+- For tools: Arguments schema needed to pass to use_tool
+- For skills: Detailed instructions that will expand when invoked (Prefer to be explored first when relevant)
+
+This tool is optimized for batch queries - you can request multiple capabilities at once for better performance.
+
+How to invoke:
+- For MCP tools: Use use_tool with toolName and toolArgs based on the schema
+- For skills: Use this tool with the skill name to get expanded instructions
+</instruction>
+
+<available_capabilities>
+<!-- Capabilities will be populated dynamically after MCP servers connect -->
+</available_capabilities>
+</toolkit>
+      `.trim(),
+			parameters: {
+				type: "object",
+				additionalProperties: false,
+				properties: { toolNames: {
+					description: "List of tool names to get detailed information about",
+					items: {
+						minLength: 1,
+						type: "string"
+					},
+					minItems: 1,
+					type: "array"
+				} },
+				required: ["toolNames"]
+			},
+			async execute(_id, params) {
+				if (!isInitialized || !describeToolsToolInstance) return {
+					content: [{
+						type: "text",
+						text: "MCP server not initialized yet. Please wait for service startup to complete."
+					}],
+					isError: true
+				};
+				try {
+					const result = await describeToolsToolInstance.execute(params);
+					const responseText = result.content?.[0]?.type === "text" ? result.content[0].text : JSON.stringify(result, null, 2);
+					return { content: [{
+						type: "text",
+						text: toolkitDescription ? `${toolkitDescription}\n\n---\n\nDetailed Information:\n${responseText}` : responseText
+					}] };
+				} catch (error) {
+					const errorMessage = error instanceof Error ? error.message : String(error);
+					api.logger.error("[one-mcp] describe_tools error:", errorMessage);
+					return {
+						content: [{
+							type: "text",
+							text: `Error executing describe_tools: ${errorMessage}`
+						}],
+						isError: true
+					};
+				}
+			}
+		}, { name: "mcp__describe_tools" });
+		api.registerTool({
+			name: "mcp__use_tool",
+			description: `
+Execute an MCP tool (NOT Skill) with provided arguments. You MUST call describe_tools first to discover the tool's correct arguments. Then to use tool:
+- Provide toolName and toolArgs based on the schema
+- If multiple servers provide the same tool, specify serverName
+
+IMPORTANT: Only use tools discovered from describe_tools with id="${serverOptions.serverId}".
+      `.trim(),
+			parameters: {
+				type: "object",
+				additionalProperties: false,
+				properties: {
+					toolArgs: {
+						description: "Arguments to pass to the tool, as discovered from describe_tools",
+						type: "object"
+					},
+					toolName: {
+						description: "Name of the tool to execute",
+						minLength: 1,
+						type: "string"
+					}
+				},
+				required: ["toolName"]
+			},
+			async execute(_id, params) {
+				if (!isInitialized || !useToolToolInstance) return {
+					content: [{
+						type: "text",
+						text: "MCP server not initialized yet. Please wait for service startup to complete."
+					}],
+					isError: true
+				};
+				try {
+					const result = await useToolToolInstance.execute(params);
+					return { content: result.content || [{
+						type: "text",
+						text: JSON.stringify(result, null, 2)
+					}] };
+				} catch (error) {
+					const errorMessage = error instanceof Error ? error.message : String(error);
+					api.logger.error("[one-mcp] use_tool error:", errorMessage);
+					return {
+						content: [{
+							type: "text",
+							text: `Error executing tool: ${errorMessage}`
+						}],
+						isError: true
+					};
+				}
+			}
+		}, { name: "mcp__use_tool" });
+		api.logger.info("[one-mcp] Tools registered: mcp__describe_tools, mcp__use_tool");
+	}
+};
+var plugin_default = mcpBridgePlugin;
+
+//#endregion
+module.exports = plugin_default;

package/dist/plugin.d.cts

@@ -0,0 +1,17 @@
+import { t as ClawdbotApi } from "./index-BTWlYpm4.cjs";
+import * as _sinclair_typebox0 from "@sinclair/typebox";
+
+//#region src/plugin.d.ts
+
+declare const mcpBridgePlugin: {
+  id: string;
+  name: string;
+  description: string;
+  configSchema: _sinclair_typebox0.TObject<{
+    configFilePath: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
+    serverId: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
+    noCache: _sinclair_typebox0.TOptional<_sinclair_typebox0.TBoolean>;
+  }>;
+  register(api: ClawdbotApi): void;
+};
+export = mcpBridgePlugin;

package/dist/plugin.d.ts

@@ -0,0 +1,18 @@
+import { t as ClawdbotApi } from "./index-Ca12Wuvd.js";
+import * as _sinclair_typebox0 from "@sinclair/typebox";
+
+//#region src/plugin.d.ts
+
+declare const mcpBridgePlugin: {
+  id: string;
+  name: string;
+  description: string;
+  configSchema: _sinclair_typebox0.TObject<{
+    configFilePath: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
+    serverId: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
+    noCache: _sinclair_typebox0.TOptional<_sinclair_typebox0.TBoolean>;
+  }>;
+  register(api: ClawdbotApi): void;
+};
+//#endregion
+export { mcpBridgePlugin as default };

package/dist/plugin.js

@@ -0,0 +1,195 @@
+import { Type } from "@sinclair/typebox";
+import { ConfigFetcherService, DescribeToolsTool, McpClientManagerService, SkillService, UseToolTool } from "@agiflowai/one-mcp";
+
+//#region src/plugin.ts
+const mcpBridgePlugin = {
+	id: "clawdbot-mcp-plugin",
+	name: "MCP Server Bridge",
+	description: "Enables Model Context Protocol (MCP) server integration with progressive tool disclosure",
+	configSchema: Type.Object({
+		configFilePath: Type.Optional(Type.String({
+			description: "Path to mcp-config.yaml file (supports one-mcp's YAML format)",
+			default: ".clawdbot/mcp-config.yaml"
+		})),
+		serverId: Type.Optional(Type.String({
+			description: "Unique identifier for the toolkit",
+			default: "clawdbot-mcp"
+		})),
+		noCache: Type.Optional(Type.Boolean({
+			description: "Disable configuration caching",
+			default: false
+		}))
+	}),
+	register(api) {
+		const pluginConfig = api.pluginConfig || {};
+		const serverOptions = {
+			configFilePath: pluginConfig.configFilePath || ".clawdbot/mcp-config.yaml",
+			serverId: pluginConfig.serverId || "clawdbot-mcp",
+			noCache: pluginConfig.noCache || false
+		};
+		let describeToolsToolInstance = null;
+		let useToolToolInstance = null;
+		let isInitialized = false;
+		let toolkitDescription = null;
+		api.registerService({
+			id: "mcp-server",
+			async start() {
+				try {
+					api.logger.info(`[one-mcp] Initializing MCP server with config: ${serverOptions.configFilePath}`);
+					const clientManager = new McpClientManagerService();
+					const config = await new ConfigFetcherService({
+						configFilePath: serverOptions.configFilePath,
+						useCache: !serverOptions.noCache
+					}).fetchConfiguration(serverOptions.noCache || false);
+					const connectionPromises = Object.entries(config.mcpServers).map(async ([serverName, serverConfig]) => {
+						try {
+							await clientManager.connectToServer(serverName, serverConfig);
+							api.logger.info(`[one-mcp] Connected to MCP server: ${serverName}`);
+						} catch (error) {
+							const errorMessage = error instanceof Error ? error.message : String(error);
+							api.logger.error(`[one-mcp] Failed to connect to ${serverName}:`, errorMessage);
+						}
+					});
+					await Promise.all(connectionPromises);
+					const skillsConfig = config.skills;
+					const skillService = skillsConfig && skillsConfig.paths.length > 0 ? new SkillService(process.cwd(), skillsConfig.paths) : void 0;
+					describeToolsToolInstance = new DescribeToolsTool(clientManager, skillService, serverOptions.serverId);
+					useToolToolInstance = new UseToolTool(clientManager, skillService, serverOptions.serverId);
+					toolkitDescription = (await describeToolsToolInstance.getDefinition()).description;
+					isInitialized = true;
+					api.logger.info("[one-mcp] MCP server initialized successfully");
+				} catch (error) {
+					const errorMessage = error instanceof Error ? error.message : String(error);
+					api.logger.error("[one-mcp] Failed to initialize MCP server:", errorMessage);
+					throw error;
+				}
+			},
+			async stop() {
+				api.logger.info("[one-mcp] MCP server stopping");
+				isInitialized = false;
+				describeToolsToolInstance = null;
+				useToolToolInstance = null;
+			}
+		});
+		api.registerTool({
+			name: "mcp__describe_tools",
+			description: `
+<toolkit id="${serverOptions.serverId}">
+<instruction>
+Before you use any capabilities below, you MUST call this tool with a list of names to learn how to use them properly; this includes:
+- For tools: Arguments schema needed to pass to use_tool
+- For skills: Detailed instructions that will expand when invoked (Prefer to be explored first when relevant)
+
+This tool is optimized for batch queries - you can request multiple capabilities at once for better performance.
+
+How to invoke:
+- For MCP tools: Use use_tool with toolName and toolArgs based on the schema
+- For skills: Use this tool with the skill name to get expanded instructions
+</instruction>
+
+<available_capabilities>
+<!-- Capabilities will be populated dynamically after MCP servers connect -->
+</available_capabilities>
+</toolkit>
+      `.trim(),
+			parameters: {
+				type: "object",
+				additionalProperties: false,
+				properties: { toolNames: {
+					description: "List of tool names to get detailed information about",
+					items: {
+						minLength: 1,
+						type: "string"
+					},
+					minItems: 1,
+					type: "array"
+				} },
+				required: ["toolNames"]
+			},
+			async execute(_id, params) {
+				if (!isInitialized || !describeToolsToolInstance) return {
+					content: [{
+						type: "text",
+						text: "MCP server not initialized yet. Please wait for service startup to complete."
+					}],
+					isError: true
+				};
+				try {
+					const result = await describeToolsToolInstance.execute(params);
+					const responseText = result.content?.[0]?.type === "text" ? result.content[0].text : JSON.stringify(result, null, 2);
+					return { content: [{
+						type: "text",
+						text: toolkitDescription ? `${toolkitDescription}\n\n---\n\nDetailed Information:\n${responseText}` : responseText
+					}] };
+				} catch (error) {
+					const errorMessage = error instanceof Error ? error.message : String(error);
+					api.logger.error("[one-mcp] describe_tools error:", errorMessage);
+					return {
+						content: [{
+							type: "text",
+							text: `Error executing describe_tools: ${errorMessage}`
+						}],
+						isError: true
+					};
+				}
+			}
+		}, { name: "mcp__describe_tools" });
+		api.registerTool({
+			name: "mcp__use_tool",
+			description: `
+Execute an MCP tool (NOT Skill) with provided arguments. You MUST call describe_tools first to discover the tool's correct arguments. Then to use tool:
+- Provide toolName and toolArgs based on the schema
+- If multiple servers provide the same tool, specify serverName
+
+IMPORTANT: Only use tools discovered from describe_tools with id="${serverOptions.serverId}".
+      `.trim(),
+			parameters: {
+				type: "object",
+				additionalProperties: false,
+				properties: {
+					toolArgs: {
+						description: "Arguments to pass to the tool, as discovered from describe_tools",
+						type: "object"
+					},
+					toolName: {
+						description: "Name of the tool to execute",
+						minLength: 1,
+						type: "string"
+					}
+				},
+				required: ["toolName"]
+			},
+			async execute(_id, params) {
+				if (!isInitialized || !useToolToolInstance) return {
+					content: [{
+						type: "text",
+						text: "MCP server not initialized yet. Please wait for service startup to complete."
+					}],
+					isError: true
+				};
+				try {
+					const result = await useToolToolInstance.execute(params);
+					return { content: result.content || [{
+						type: "text",
+						text: JSON.stringify(result, null, 2)
+					}] };
+				} catch (error) {
+					const errorMessage = error instanceof Error ? error.message : String(error);
+					api.logger.error("[one-mcp] use_tool error:", errorMessage);
+					return {
+						content: [{
+							type: "text",
+							text: `Error executing tool: ${errorMessage}`
+						}],
+						isError: true
+					};
+				}
+			}
+		}, { name: "mcp__use_tool" });
+		api.logger.info("[one-mcp] Tools registered: mcp__describe_tools, mcp__use_tool");
+	}
+};
+var plugin_default = mcpBridgePlugin;
+
+//#endregion
+export { plugin_default as default };

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@agiflowai/clawdbot-mcp-plugin",
+  "description": "Clawdbot plugin for MCP server integration with progressive tool disclosure",
+  "version": "0.1.0",
+  "license": "AGPL-3.0",
+  "author": "AgiflowIO",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AgiFlow/aicode-toolkit.git",
+    "directory": "packages/clawdbot-mcp-plugin"
+  },
+  "homepage": "https://github.com/AgiFlow/aicode-toolkit#readme",
+  "bugs": {
+    "url": "https://github.com/AgiFlow/aicode-toolkit/issues"
+  },
+  "keywords": [
+    "typescript",
+    "library",
+    "clawdbot",
+    "mcp",
+    "plugin"
+  ],
+  "clawdbot": {
+    "extensions": [
+      "dist/plugin.js"
+    ]
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.cts",
+  "files": [
+    "dist",
+    "README.md",
+    "clawdbot.plugin.json"
+  ],
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.0",
+    "@agiflowai/one-mcp": "0.3.6"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "1.24.0",
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^3.0.0",
+    "tsdown": "^0.15.6",
+    "typescript": "5.9.3",
+    "vitest": "4.0.15"
+  },
+  "peerDependencies": {
+    "clawdbot": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "clawdbot": {
+      "optional": true
+    }
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./plugin": {
+      "import": "./dist/plugin.js",
+      "require": "./dist/plugin.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit"
+  }
+}