@bowenqt/qiniu-ai-sdk 0.10.0 → 0.13.0

package/dist/modules/mcp/client.mjs

@@ -0,0 +1,295 @@
+/**
+ * MCP Client with stdio and HTTP transport support.
+ * Phase 1: Bearer token, Phase 3: OAuth 2.0
+ */
+import { spawn } from 'child_process';
+import { DEFAULT_MCP_CONFIG } from './types.mjs';
+import { noopLogger } from '../../lib/logger.mjs';
+import { MCPHttpTransport } from './http-transport.mjs';
+/** MCP Client error */
+export class MCPClientError extends Error {
+    constructor(message, serverName) {
+        super(message);
+        this.serverName = serverName;
+        this.name = 'MCPClientError';
+    }
+}
+/**
+ * MCP Client manages connections to MCP servers.
+ */
+export class MCPClient {
+    constructor(config, logger) {
+        this.connections = new Map();
+        this.config = {
+            servers: config.servers,
+            connectionTimeout: config.connectionTimeout ?? DEFAULT_MCP_CONFIG.connectionTimeout,
+        };
+        this.logger = logger ?? noopLogger;
+        // Initialize connections (not started)
+        for (const server of this.config.servers) {
+            this.connections.set(server.name, {
+                config: server,
+                process: null,
+                httpTransport: null,
+                state: 'disconnected',
+                tools: [],
+                requestId: 0,
+                pendingRequests: new Map(),
+                buffer: '',
+            });
+        }
+    }
+    /**
+     * Connect to all configured servers.
+     */
+    async connect() {
+        const promises = Array.from(this.connections.keys()).map(name => this.connectServer(name));
+        await Promise.all(promises);
+    }
+    /**
+     * Connect to a specific server.
+     */
+    async connectServer(serverName) {
+        const conn = this.connections.get(serverName);
+        if (!conn) {
+            throw new MCPClientError(`Server not found: ${serverName}`, serverName);
+        }
+        if (conn.state === 'connected') {
+            return;
+        }
+        conn.state = 'connecting';
+        try {
+            if (conn.config.transport === 'http') {
+                // HTTP transport (Phase 3)
+                const httpConfig = conn.config;
+                // Validate authentication configuration
+                if (httpConfig.oauth && !httpConfig.token && !httpConfig.tokenProvider) {
+                    throw new MCPClientError(`OAuth configured for '${serverName}' but no token or tokenProvider provided. ` +
+                        'Use PKCEFlow/DeviceCodeFlow to obtain tokens first, then provide via token or tokenProvider.', serverName);
+                }
+                conn.httpTransport = new MCPHttpTransport(httpConfig);
+                // Connect with timeout
+                await Promise.race([
+                    conn.httpTransport.connect(),
+                    new Promise((_, reject) => setTimeout(() => reject(new MCPClientError('Connection timeout', serverName)), this.config.connectionTimeout)),
+                ]);
+                // List tools via HTTP transport
+                conn.tools = await conn.httpTransport.listTools();
+                conn.state = 'connected';
+                this.logger.info('MCP HTTP server connected', {
+                    server: serverName,
+                    tools: conn.tools.length,
+                });
+            }
+            else {
+                // Stdio transport (Phase 1)
+                const { command, args = [], env = {}, token } = conn.config;
+                // Inject bearer token via env if configured
+                const processEnv = { ...process.env, ...env };
+                if (token) {
+                    processEnv.MCP_BEARER_TOKEN = token;
+                }
+                conn.process = spawn(command, args, {
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                    env: processEnv,
+                });
+                // Handle stdout (JSON-RPC responses)
+                conn.process.stdout?.on('data', (data) => {
+                    this.handleData(serverName, data.toString());
+                });
+                // Handle stderr (logs)
+                conn.process.stderr?.on('data', (data) => {
+                    this.logger.debug('MCP server stderr', { server: serverName, data: data.toString() });
+                });
+                // Handle exit
+                conn.process.on('exit', (code) => {
+                    this.logger.info('MCP server exited', { server: serverName, code });
+                    conn.state = 'disconnected';
+                    conn.process = null;
+                });
+                // Wait for connection with timeout
+                await Promise.race([
+                    this.initialize(serverName),
+                    new Promise((_, reject) => setTimeout(() => reject(new MCPClientError('Connection timeout', serverName)), this.config.connectionTimeout)),
+                ]);
+                // List tools
+                conn.tools = await this.listToolsInternal(serverName);
+                conn.state = 'connected';
+                this.logger.info('MCP server connected', {
+                    server: serverName,
+                    tools: conn.tools.length,
+                });
+            }
+        }
+        catch (error) {
+            conn.state = 'error';
+            throw error;
+        }
+    }
+    /**
+     * Disconnect from all servers.
+     */
+    async disconnect() {
+        for (const [name, conn] of this.connections) {
+            if (conn.httpTransport) {
+                await conn.httpTransport.disconnect();
+                conn.httpTransport = null;
+                conn.state = 'disconnected';
+                this.logger.info('MCP HTTP server disconnected', { server: name });
+            }
+            else if (conn.process) {
+                conn.process.kill();
+                conn.process = null;
+                conn.state = 'disconnected';
+                this.logger.info('MCP server disconnected', { server: name });
+            }
+        }
+    }
+    /**
+     * Get all tools from all connected servers.
+     * Sorted by server name, then tool name for deterministic order.
+     * Only returns tools from servers with state 'connected'.
+     */
+    getAllTools() {
+        const allTools = [];
+        const serverNames = Array.from(this.connections.keys()).sort();
+        for (const serverName of serverNames) {
+            const conn = this.connections.get(serverName);
+            // Only include tools from connected servers
+            if (conn.state !== 'connected')
+                continue;
+            for (const tool of conn.tools) {
+                allTools.push({ ...tool, server: serverName });
+            }
+        }
+        // Sort by tool name
+        return allTools.sort((a, b) => a.name.localeCompare(b.name));
+    }
+    /**
+     * Execute a tool.
+     */
+    async executeTool(serverName, toolName, args) {
+        const conn = this.connections.get(serverName);
+        if (!conn || conn.state !== 'connected') {
+            throw new MCPClientError(`Server not connected: ${serverName}`, serverName);
+        }
+        // HTTP transport uses MCPHttpTransport
+        if (conn.httpTransport) {
+            return conn.httpTransport.executeTool(toolName, args);
+        }
+        // Stdio transport uses JSON-RPC
+        return this.sendRequest(serverName, 'tools/call', {
+            name: toolName,
+            arguments: args,
+        });
+    }
+    /**
+     * Get connection state.
+     */
+    getState(serverName) {
+        return this.connections.get(serverName)?.state ?? 'disconnected';
+    }
+    /**
+     * Get tools for a specific server.
+     */
+    getServerTools(serverName) {
+        const conn = this.connections.get(serverName);
+        if (!conn || conn.state !== 'connected') {
+            return [];
+        }
+        return conn.tools;
+    }
+    /**
+     * Get names of all connected servers.
+     */
+    getConnectedServerNames() {
+        const names = [];
+        for (const [name, conn] of this.connections) {
+            if (conn.state === 'connected') {
+                names.push(name);
+            }
+        }
+        return names.sort();
+    }
+    /**
+     * Initialize connection (MCP handshake).
+     */
+    async initialize(serverName) {
+        await this.sendRequest(serverName, 'initialize', {
+            protocolVersion: '2024-11-05',
+            capabilities: {},
+            clientInfo: {
+                name: 'qiniu-ai-sdk',
+                version: '0.11.0',
+            },
+        });
+        await this.sendNotification(serverName, 'notifications/initialized', {});
+    }
+    /**
+     * List tools from server.
+     */
+    async listToolsInternal(serverName) {
+        const result = await this.sendRequest(serverName, 'tools/list', {});
+        return result.tools ?? [];
+    }
+    /**
+     * Send JSON-RPC request.
+     */
+    sendRequest(serverName, method, params) {
+        const conn = this.connections.get(serverName);
+        const id = ++conn.requestId;
+        const message = JSON.stringify({
+            jsonrpc: '2.0',
+            id,
+            method,
+            params,
+        }) + '\n';
+        return new Promise((resolve, reject) => {
+            conn.pendingRequests.set(id, { resolve, reject });
+            conn.process?.stdin?.write(message);
+        });
+    }
+    /**
+     * Send JSON-RPC notification.
+     */
+    sendNotification(serverName, method, params) {
+        const conn = this.connections.get(serverName);
+        const message = JSON.stringify({
+            jsonrpc: '2.0',
+            method,
+            params,
+        }) + '\n';
+        conn.process?.stdin?.write(message);
+    }
+    /**
+     * Handle incoming data.
+     */
+    handleData(serverName, data) {
+        const conn = this.connections.get(serverName);
+        conn.buffer += data;
+        // Process complete messages
+        const lines = conn.buffer.split('\n');
+        conn.buffer = lines.pop() ?? '';
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            try {
+                const message = JSON.parse(line);
+                if (message.id !== undefined && conn.pendingRequests.has(message.id)) {
+                    const { resolve, reject } = conn.pendingRequests.get(message.id);
+                    conn.pendingRequests.delete(message.id);
+                    if (message.error) {
+                        reject(new MCPClientError(message.error.message, serverName));
+                    }
+                    else {
+                        resolve(message.result);
+                    }
+                }
+            }
+            catch {
+                this.logger.warn('Failed to parse MCP message', { server: serverName, line });
+            }
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/modules/mcp/http-transport.d.ts

@@ -0,0 +1,51 @@
+/**
+ * MCP HTTP Transport using official SDK.
+ * Wraps StreamableHTTPClientTransport with retries and connection management.
+ *
+ * @see https://modelcontextprotocol.io/docs/concepts/transports#streamable-http
+ */
+import type { MCPHttpServerConfig, MCPToolDefinition, MCPToolResult } from './types';
+/** HTTP Transport error */
+export declare class MCPHttpTransportError extends Error {
+    readonly serverName: string;
+    readonly statusCode?: number | undefined;
+    constructor(message: string, serverName: string, statusCode?: number | undefined);
+}
+/** OAuth token provider function */
+export type TokenProvider = () => Promise<string | undefined>;
+/**
+ * HTTP Transport wrapper for MCP servers.
+ * Uses official SDK's StreamableHTTPClientTransport.
+ */
+export declare class MCPHttpTransport {
+    private client;
+    private transport;
+    private readonly config;
+    private connected;
+    constructor(config: MCPHttpServerConfig);
+    /**
+     * Connect to the MCP server.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the MCP server.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * List available tools.
+     */
+    listTools(): Promise<MCPToolDefinition[]>;
+    /**
+     * Execute a tool.
+     */
+    executeTool(toolName: string, args: Record<string, unknown>): Promise<MCPToolResult>;
+    /**
+     * Check if connected.
+     */
+    isConnected(): boolean;
+    /**
+     * Get server name.
+     */
+    getServerName(): string;
+}
+//# sourceMappingURL=http-transport.d.ts.map

package/dist/modules/mcp/http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-transport.d.ts","sourceRoot":"","sources":["../../../src/modules/mcp/http-transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGrF,2BAA2B;AAC3B,qBAAa,qBAAsB,SAAQ,KAAK;aAGxB,UAAU,EAAE,MAAM;aAClB,UAAU,CAAC,EAAE,MAAM;gBAFnC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,YAAA;CAK1C;AAED,oCAAoC;AACpC,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAE9D;;;GAGG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,mBAAmB;IAIvC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwD9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAa/C;;OAEG;IACG,WAAW,CACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,aAAa,CAAC;IA8BzB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,aAAa,IAAI,MAAM;CAG1B"}

package/dist/modules/mcp/http-transport.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * MCP HTTP Transport using official SDK.
+ * Wraps StreamableHTTPClientTransport with retries and connection management.
+ *
+ * @see https://modelcontextprotocol.io/docs/concepts/transports#streamable-http
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPHttpTransport = exports.MCPHttpTransportError = void 0;
+const index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
+const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
+const types_1 = require("./types");
+/** HTTP Transport error */
+class MCPHttpTransportError extends Error {
+    constructor(message, serverName, statusCode) {
+        super(message);
+        this.serverName = serverName;
+        this.statusCode = statusCode;
+        this.name = 'MCPHttpTransportError';
+    }
+}
+exports.MCPHttpTransportError = MCPHttpTransportError;
+/**
+ * HTTP Transport wrapper for MCP servers.
+ * Uses official SDK's StreamableHTTPClientTransport.
+ */
+class MCPHttpTransport {
+    constructor(config) {
+        this.client = null;
+        this.transport = null;
+        this.connected = false;
+        this.config = config;
+    }
+    /**
+     * Connect to the MCP server.
+     */
+    async connect() {
+        if (this.connected)
+            return;
+        // Build headers
+        const headers = {
+            ...this.config.headers,
+        };
+        // Add bearer token if available
+        if (this.config.token) {
+            headers['Authorization'] = `Bearer ${this.config.token}`;
+        }
+        else if (this.config.tokenProvider) {
+            const token = await this.config.tokenProvider();
+            if (token) {
+                headers['Authorization'] = `Bearer ${token}`;
+            }
+        }
+        // Create transport
+        this.transport = new streamableHttp_js_1.StreamableHTTPClientTransport(new URL(this.config.url), {
+            requestInit: {
+                headers,
+            },
+        });
+        // Create client
+        this.client = new index_js_1.Client({
+            name: 'qiniu-sdk',
+            version: '0.13.0',
+        }, {
+            capabilities: {},
+        });
+        // Connect with timeout
+        const timeout = this.config.timeout ?? types_1.DEFAULT_MCP_CONFIG.httpTimeout;
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => reject(new MCPHttpTransportError(`Connection timeout after ${timeout}ms`, this.config.name)), timeout);
+        });
+        await Promise.race([
+            this.client.connect(this.transport),
+            timeoutPromise,
+        ]);
+        this.connected = true;
+    }
+    /**
+     * Disconnect from the MCP server.
+     */
+    async disconnect() {
+        if (!this.connected)
+            return;
+        await this.client?.close();
+        this.client = null;
+        this.transport = null;
+        this.connected = false;
+    }
+    /**
+     * List available tools.
+     */
+    async listTools() {
+        if (!this.client) {
+            throw new MCPHttpTransportError('Not connected', this.config.name);
+        }
+        const result = await this.client.listTools();
+        return (result.tools || []).map((tool) => ({
+            name: tool.name,
+            description: tool.description || '',
+            inputSchema: tool.inputSchema,
+        }));
+    }
+    /**
+     * Execute a tool.
+     */
+    async executeTool(toolName, args) {
+        if (!this.client) {
+            throw new MCPHttpTransportError('Not connected', this.config.name);
+        }
+        const result = await this.client.callTool({
+            name: toolName,
+            arguments: args,
+        });
+        const contentArray = Array.isArray(result.content) ? result.content : [];
+        return {
+            content: contentArray.map((item) => {
+                if (item.type === 'text') {
+                    return { type: 'text', text: item.text };
+                }
+                if (item.type === 'image') {
+                    return {
+                        type: 'image',
+                        data: item.data,
+                        mimeType: item.mimeType,
+                    };
+                }
+                return { type: 'resource' };
+            }),
+            isError: result.isError === true,
+        };
+    }
+    /**
+     * Check if connected.
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Get server name.
+     */
+    getServerName() {
+        return this.config.name;
+    }
+}
+exports.MCPHttpTransport = MCPHttpTransport;
+//# sourceMappingURL=http-transport.js.map

package/dist/modules/mcp/http-transport.js.map

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

package/dist/modules/mcp/http-transport.mjs

@@ -0,0 +1,141 @@
+/**
+ * MCP HTTP Transport using official SDK.
+ * Wraps StreamableHTTPClientTransport with retries and connection management.
+ *
+ * @see https://modelcontextprotocol.io/docs/concepts/transports#streamable-http
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { DEFAULT_MCP_CONFIG } from './types.mjs';
+/** HTTP Transport error */
+export class MCPHttpTransportError extends Error {
+    constructor(message, serverName, statusCode) {
+        super(message);
+        this.serverName = serverName;
+        this.statusCode = statusCode;
+        this.name = 'MCPHttpTransportError';
+    }
+}
+/**
+ * HTTP Transport wrapper for MCP servers.
+ * Uses official SDK's StreamableHTTPClientTransport.
+ */
+export class MCPHttpTransport {
+    constructor(config) {
+        this.client = null;
+        this.transport = null;
+        this.connected = false;
+        this.config = config;
+    }
+    /**
+     * Connect to the MCP server.
+     */
+    async connect() {
+        if (this.connected)
+            return;
+        // Build headers
+        const headers = {
+            ...this.config.headers,
+        };
+        // Add bearer token if available
+        if (this.config.token) {
+            headers['Authorization'] = `Bearer ${this.config.token}`;
+        }
+        else if (this.config.tokenProvider) {
+            const token = await this.config.tokenProvider();
+            if (token) {
+                headers['Authorization'] = `Bearer ${token}`;
+            }
+        }
+        // Create transport
+        this.transport = new StreamableHTTPClientTransport(new URL(this.config.url), {
+            requestInit: {
+                headers,
+            },
+        });
+        // Create client
+        this.client = new Client({
+            name: 'qiniu-sdk',
+            version: '0.13.0',
+        }, {
+            capabilities: {},
+        });
+        // Connect with timeout
+        const timeout = this.config.timeout ?? DEFAULT_MCP_CONFIG.httpTimeout;
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => reject(new MCPHttpTransportError(`Connection timeout after ${timeout}ms`, this.config.name)), timeout);
+        });
+        await Promise.race([
+            this.client.connect(this.transport),
+            timeoutPromise,
+        ]);
+        this.connected = true;
+    }
+    /**
+     * Disconnect from the MCP server.
+     */
+    async disconnect() {
+        if (!this.connected)
+            return;
+        await this.client?.close();
+        this.client = null;
+        this.transport = null;
+        this.connected = false;
+    }
+    /**
+     * List available tools.
+     */
+    async listTools() {
+        if (!this.client) {
+            throw new MCPHttpTransportError('Not connected', this.config.name);
+        }
+        const result = await this.client.listTools();
+        return (result.tools || []).map((tool) => ({
+            name: tool.name,
+            description: tool.description || '',
+            inputSchema: tool.inputSchema,
+        }));
+    }
+    /**
+     * Execute a tool.
+     */
+    async executeTool(toolName, args) {
+        if (!this.client) {
+            throw new MCPHttpTransportError('Not connected', this.config.name);
+        }
+        const result = await this.client.callTool({
+            name: toolName,
+            arguments: args,
+        });
+        const contentArray = Array.isArray(result.content) ? result.content : [];
+        return {
+            content: contentArray.map((item) => {
+                if (item.type === 'text') {
+                    return { type: 'text', text: item.text };
+                }
+                if (item.type === 'image') {
+                    return {
+                        type: 'image',
+                        data: item.data,
+                        mimeType: item.mimeType,
+                    };
+                }
+                return { type: 'resource' };
+            }),
+            isError: result.isError === true,
+        };
+    }
+    /**
+     * Check if connected.
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Get server name.
+     */
+    getServerName() {
+        return this.config.name;
+    }
+}
+//# sourceMappingURL=http-transport.js.map

package/dist/modules/mcp/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MCP module public exports.
+ */
+export { MCPClient, MCPClientError } from './client';
+export { adaptMCPToolsToRegistry, getAllMCPToolsAsRegistered } from './adapter';
+export { MCPHttpTransport, MCPHttpTransportError, type TokenProvider } from './http-transport';
+export { PKCEFlow, DeviceCodeFlow, OAuthError, generateCodeVerifier, generateCodeChallenge, generateState, refreshAccessToken, type OAuthTokens, } from './oauth';
+export { MemoryTokenStore, FileTokenStore, TokenManager, type TokenStore, type FileTokenStoreConfig, } from './token-store';
+export type { MCPClientConfig, MCPServerConfig, MCPStdioServerConfig, MCPHttpServerConfig, MCPOAuthConfig, MCPToolDefinition, MCPToolResult, MCPConnectionState, MCPTransport, } from './types';
+export { DEFAULT_MCP_CONFIG } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/mcp/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAGhF,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG/F,OAAO,EACH,QAAQ,EACR,cAAc,EACd,UAAU,EACV,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,KAAK,WAAW,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,oBAAoB,GAC5B,MAAM,eAAe,CAAC;AAGvB,YAAY,EACR,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,YAAY,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC"}