@cloudbase/cloudbase-mcp 2.25.9 → 2.26.0

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 import CloudBase from '@cloudbase/manager-node';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolAnnotations as ToolAnnotations_2 } from '@modelcontextprotocol/sdk/types.js';
 
 export declare const ALL_SUPPORTED_RUNTIMES: ("Nodejs20.19" | "Nodejs18.15" | "Nodejs16.13" | "Nodejs14.18" | "Nodejs12.16" | "Nodejs10.15" | "Nodejs8.9" | "Python3.10" | "Python3.9" | "Python3.7" | "Python3.6" | "Python2.7" | "Php8.0" | "Php7.4" | "Php7.2" | "Java8" | "Java11" | "Golang1")[];
 
@@ -32,6 +35,19 @@ export declare type CloudBaseOptions = CloudBaseConfigBase & {
     requestFn?: CloudApiRequestFn;
 };
 
+/**
+ * registerTool config with CloudBase `annotations.category` retained after
+ * MCP SDK >=1.26 closed ToolAnnotations to strip unknown keys at the type level.
+ */
+export declare type CloudBaseRegisterToolConfig = {
+    title?: string;
+    description?: string;
+    inputSchema?: any;
+    outputSchema?: any;
+    annotations?: ToolAnnotations;
+    _meta?: Record<string, unknown>;
+};
+
 /**
  * Create a manager with the provided CloudBase options, without using cache
  * @param cloudBaseOptions Provided CloudBase options
@@ -161,7 +177,7 @@ export declare interface ExtendedMcpServer extends McpServer {
     logger?: Logger;
     enabledPlugins?: string[];
     pluginOptions?: PluginOptions;
-    /** 已注册工具的列表，供外部（如微信 IDE）提取并注册到自己的 MCP server */
+    /** Registered tools for external hosts (e.g. WeChat IDE) to re-register. */
     toolDefs: Array<{
         name: string;
         description: string;
@@ -169,6 +185,11 @@ export declare interface ExtendedMcpServer extends McpServer {
         handler: (input: any) => Promise<any>;
     }>;
     setLogger(logger: Logger): void;
+    /**
+     * Same as MCP SDK registerTool, but annotations may include CloudBase `category`.
+     * Handler typing stays intentionally loose to match existing tool call sites.
+     */
+    registerTool(name: string, config: CloudBaseRegisterToolConfig, cb: (...args: any[]) => any): RegisteredTool;
 }
 
 export declare function formatRuntimeList(): string;
@@ -528,6 +549,18 @@ declare class TelemetryReporter {
 
 export declare const telemetryReporter: TelemetryReporter;
 
+export { Tool }
+
+/**
+ * CloudBase extends MCP ToolAnnotations with a stable `category` hint used by
+ * IDE UIs for grouping. SDK >=1.26 types annotations as a closed/strip object,
+ * so we keep category via an intersection while still passing it through at
+ * runtime (listTools returns registered annotations without schema stripping).
+ */
+export declare type ToolAnnotations = ToolAnnotations_2 & {
+    category?: string;
+};
+
 export declare interface ToolResponse {
     success: boolean;
     [key: string]: any;