@cogitator-ai/mcp 0.1.0

package/dist/client/mcp-client.js

@@ -0,0 +1,276 @@
+/**
+ * MCP Client
+ *
+ * Connects to external MCP servers and provides access to their tools,
+ * resources, and prompts.
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { createStdioTransport, createHttpTransport } from './transports';
+import { mcpToCogitator } from '../adapter/tool-adapter';
+/**
+ * MCP Client for connecting to external MCP servers
+ *
+ * @example
+ * ```typescript
+ * // Connect to a filesystem MCP server
+ * const client = await MCPClient.connect({
+ *   transport: 'stdio',
+ *   command: 'npx',
+ *   args: ['-y', '@anthropic/mcp-server-filesystem', '/allowed/path'],
+ * });
+ *
+ * // Get available tools as Cogitator tools
+ * const tools = await client.getTools();
+ *
+ * // Use them with an agent
+ * const agent = new Agent({
+ *   tools: [...tools],
+ *   ...
+ * });
+ *
+ * // Don't forget to disconnect
+ * await client.close();
+ * ```
+ */
+export class MCPClient {
+    client;
+    transport;
+    connected = false;
+    serverCapabilities = {};
+    constructor(client, transport) {
+        this.client = client;
+        this.transport = transport;
+    }
+    /**
+     * Connect to an MCP server
+     */
+    static async connect(config) {
+        const client = new Client({
+            name: config.clientName ?? 'cogitator-mcp-client',
+            version: config.clientVersion ?? '1.0.0',
+        });
+        const transport = MCPClient.createTransport(config);
+        const mcpClient = new MCPClient(client, transport);
+        await mcpClient.initialize(config.timeout);
+        return mcpClient;
+    }
+    /**
+     * Create transport based on configuration
+     */
+    static createTransport(config) {
+        switch (config.transport) {
+            case 'stdio':
+                if (!config.command) {
+                    throw new Error('Command is required for stdio transport');
+                }
+                return createStdioTransport({
+                    command: config.command,
+                    args: config.args,
+                    env: config.env,
+                });
+            case 'http':
+            case 'sse':
+                if (!config.url) {
+                    throw new Error('URL is required for HTTP transport');
+                }
+                return createHttpTransport({
+                    url: config.url,
+                });
+            default:
+                throw new Error(`Unknown transport type: ${config.transport}`);
+        }
+    }
+    /**
+     * Initialize connection and capabilities
+     */
+    async initialize(timeout) {
+        const timeoutPromise = timeout
+            ? new Promise((_, reject) => setTimeout(() => reject(new Error('Connection timeout')), timeout))
+            : null;
+        const connectPromise = this.client.connect(this.transport);
+        if (timeoutPromise) {
+            await Promise.race([connectPromise, timeoutPromise]);
+        }
+        else {
+            await connectPromise;
+        }
+        this.connected = true;
+        const serverInfo = this.client.getServerCapabilities();
+        this.serverCapabilities = {
+            tools: !!serverInfo?.tools,
+            resources: !!serverInfo?.resources,
+            prompts: !!serverInfo?.prompts,
+        };
+    }
+    /**
+     * Check if connected to server
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Get server capabilities
+     */
+    getCapabilities() {
+        return { ...this.serverCapabilities };
+    }
+    /**
+     * List available tools from the MCP server
+     */
+    async listToolDefinitions() {
+        if (!this.serverCapabilities.tools) {
+            return [];
+        }
+        const result = await this.client.listTools();
+        return result.tools.map((tool) => ({
+            name: tool.name,
+            description: tool.description ?? '',
+            inputSchema: tool.inputSchema,
+        }));
+    }
+    /**
+     * Get MCP tools as Cogitator Tool instances
+     *
+     * These tools can be directly used with Cogitator agents.
+     */
+    async getTools() {
+        const definitions = await this.listToolDefinitions();
+        return definitions.map((def) => mcpToCogitator(def, this));
+    }
+    /**
+     * Call a tool on the MCP server
+     */
+    async callTool(name, args) {
+        const result = await this.client.callTool({
+            name,
+            arguments: args,
+        });
+        const content = result.content;
+        if (content && Array.isArray(content) && content.length > 0) {
+            const firstContent = content[0];
+            if (firstContent.type === 'text') {
+                try {
+                    return JSON.parse(firstContent.text);
+                }
+                catch {
+                    return firstContent.text;
+                }
+            }
+            return firstContent;
+        }
+        return result;
+    }
+    /**
+     * List available resources from the MCP server
+     */
+    async listResources() {
+        if (!this.serverCapabilities.resources) {
+            return [];
+        }
+        const result = await this.client.listResources();
+        return result.resources.map((resource) => ({
+            uri: resource.uri,
+            name: resource.name,
+            description: resource.description,
+            mimeType: resource.mimeType,
+        }));
+    }
+    /**
+     * Read a resource from the MCP server
+     */
+    async readResource(uri) {
+        const result = await this.client.readResource({ uri });
+        if (result.contents && result.contents.length > 0) {
+            const content = result.contents[0];
+            return {
+                uri: content.uri,
+                mimeType: content.mimeType,
+                text: 'text' in content ? content.text : undefined,
+                blob: 'blob' in content ? content.blob : undefined,
+            };
+        }
+        return { uri };
+    }
+    /**
+     * List available prompts from the MCP server
+     */
+    async listPrompts() {
+        if (!this.serverCapabilities.prompts) {
+            return [];
+        }
+        const result = await this.client.listPrompts();
+        return result.prompts.map((prompt) => ({
+            name: prompt.name,
+            description: prompt.description,
+            arguments: prompt.arguments?.map((arg) => ({
+                name: arg.name,
+                description: arg.description,
+                required: arg.required,
+            })),
+        }));
+    }
+    /**
+     * Get a prompt from the MCP server
+     */
+    async getPrompt(name, args) {
+        const result = await this.client.getPrompt({
+            name,
+            arguments: args,
+        });
+        return result.messages.map((msg) => {
+            const content = msg.content;
+            return {
+                role: msg.role,
+                content: {
+                    type: content.type,
+                    text: content.type === 'text' ? content.text : undefined,
+                    data: content.type === 'image' ? content.data : undefined,
+                    mimeType: content.type === 'image' ? content.mimeType : undefined,
+                    resource: content.type === 'resource'
+                        ? {
+                            uri: content.resource.uri,
+                            text: 'text' in content.resource ? content.resource.text : undefined,
+                            blob: 'blob' in content.resource ? content.resource.blob : undefined,
+                        }
+                        : undefined,
+                },
+            };
+        });
+    }
+    /**
+     * Close the connection to the MCP server
+     */
+    async close() {
+        if (this.connected) {
+            await this.client.close();
+            this.connected = false;
+        }
+    }
+}
+/**
+ * Helper function to connect to an MCP server and get tools in one step
+ *
+ * @example
+ * ```typescript
+ * const { tools, cleanup } = await connectMCPServer({
+ *   transport: 'stdio',
+ *   command: 'npx',
+ *   args: ['-y', '@anthropic/mcp-server-filesystem', '/path'],
+ * });
+ *
+ * const agent = new Agent({ tools });
+ *
+ * // When done
+ * await cleanup();
+ * ```
+ */
+export async function connectMCPServer(config) {
+    const client = await MCPClient.connect(config);
+    const tools = await client.getTools();
+    return {
+        client,
+        tools,
+        cleanup: () => client.close(),
+    };
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/client/mcp-client.js.map

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

package/dist/client/transports.d.ts

@@ -0,0 +1,46 @@
+/**
+ * MCP Transport Wrappers
+ *
+ * Provides factory functions for creating MCP transports.
+ */
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+export interface StdioTransportConfig {
+    /** Command to execute */
+    command: string;
+    /** Command arguments */
+    args?: string[];
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Working directory */
+    cwd?: string;
+}
+export interface HttpTransportConfig {
+    /** Server URL */
+    url: string;
+    /** Custom headers */
+    headers?: Record<string, string>;
+}
+/**
+ * Create a stdio transport for connecting to a local MCP server process
+ *
+ * @example
+ * ```typescript
+ * const transport = createStdioTransport({
+ *   command: 'npx',
+ *   args: ['-y', '@anthropic/mcp-server-filesystem', '/path/to/allowed/dir'],
+ * });
+ * ```
+ */
+export declare function createStdioTransport(config: StdioTransportConfig): Transport;
+/**
+ * Create an HTTP transport for connecting to a remote MCP server
+ *
+ * @example
+ * ```typescript
+ * const transport = createHttpTransport({
+ *   url: 'http://localhost:3000/mcp',
+ * });
+ * ```
+ */
+export declare function createHttpTransport(config: HttpTransportConfig): Transport;
+//# sourceMappingURL=transports.d.ts.map

package/dist/client/transports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transports.d.ts","sourceRoot":"","sources":["../../src/client/transports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE/E,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IAEZ,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,CAiB5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAE1E"}

package/dist/client/transports.js

@@ -0,0 +1,49 @@
+/**
+ * MCP Transport Wrappers
+ *
+ * Provides factory functions for creating MCP transports.
+ */
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+/**
+ * Create a stdio transport for connecting to a local MCP server process
+ *
+ * @example
+ * ```typescript
+ * const transport = createStdioTransport({
+ *   command: 'npx',
+ *   args: ['-y', '@anthropic/mcp-server-filesystem', '/path/to/allowed/dir'],
+ * });
+ * ```
+ */
+export function createStdioTransport(config) {
+    let env;
+    if (config.env) {
+        env = { ...config.env };
+        for (const [key, value] of Object.entries(process.env)) {
+            if (value !== undefined && !(key in env)) {
+                env[key] = value;
+            }
+        }
+    }
+    return new StdioClientTransport({
+        command: config.command,
+        args: config.args,
+        env,
+        cwd: config.cwd,
+    });
+}
+/**
+ * Create an HTTP transport for connecting to a remote MCP server
+ *
+ * @example
+ * ```typescript
+ * const transport = createHttpTransport({
+ *   url: 'http://localhost:3000/mcp',
+ * });
+ * ```
+ */
+export function createHttpTransport(config) {
+    return new StreamableHTTPClientTransport(new URL(config.url));
+}
+//# sourceMappingURL=transports.js.map

package/dist/client/transports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transports.js","sourceRoot":"","sources":["../../src/client/transports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAyBnG;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA4B;IAC/D,IAAI,GAAuC,CAAC;IAC5C,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;gBACzC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,oBAAoB,CAAC;QAC9B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG;QACH,GAAG,EAAE,MAAM,CAAC,GAAG;KAChB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA2B;IAC7D,OAAO,IAAI,6BAA6B,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @cogitator-ai/mcp - MCP (Model Context Protocol) Integration
+ *
+ * This package provides full MCP support for Cogitator:
+ * - MCPClient: Connect to external MCP servers and use their tools
+ * - MCPServer: Expose Cogitator tools as an MCP server
+ * - Tool Adapter: Convert between Cogitator and MCP tool formats
+ */
+export { MCPClient } from './client/mcp-client';
+export { createStdioTransport, createHttpTransport } from './client/transports';
+export { MCPServer } from './server/mcp-server';
+export { cogitatorToMCP, mcpToCogitator, wrapMCPTools, zodToJsonSchema, jsonSchemaToZod, } from './adapter/tool-adapter';
+export type { MCPClientConfig, MCPServerConfig, MCPTransportType, MCPResource, MCPResourceContent, MCPPrompt, MCPPromptArgument, MCPPromptMessage, MCPToolDefinition, MCPToolCallResult, MCPToolContent, ToolAdapterOptions, ConvertedTools, } from './types';
+//# 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;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAEhF,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EACL,cAAc,EACd,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @cogitator-ai/mcp - MCP (Model Context Protocol) Integration
+ *
+ * This package provides full MCP support for Cogitator:
+ * - MCPClient: Connect to external MCP servers and use their tools
+ * - MCPServer: Expose Cogitator tools as an MCP server
+ * - Tool Adapter: Convert between Cogitator and MCP tool formats
+ */
+export { MCPClient } from './client/mcp-client';
+export { createStdioTransport, createHttpTransport } from './client/transports';
+export { MCPServer } from './server/mcp-server';
+export { cogitatorToMCP, mcpToCogitator, wrapMCPTools, zodToJsonSchema, jsonSchemaToZod, } from './adapter/tool-adapter';
+//# 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;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAEhF,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EACL,cAAc,EACd,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,wBAAwB,CAAC"}

package/dist/server/mcp-server.d.ts

@@ -0,0 +1,94 @@
+/**
+ * MCP Server
+ *
+ * Exposes Cogitator tools as an MCP server that can be used by
+ * other MCP clients (e.g., Claude Desktop, other AI assistants).
+ */
+import type { Tool } from '@cogitator-ai/types';
+import type { MCPServerConfig } from '../types';
+/**
+ * MCP Server for exposing Cogitator tools
+ *
+ * @example
+ * ```typescript
+ * // Create server with tools
+ * const server = new MCPServer({
+ *   name: 'my-cogitator-server',
+ *   version: '1.0.0',
+ *   transport: 'stdio',
+ * });
+ *
+ * // Register tools
+ * server.registerTool(calculatorTool);
+ * server.registerTool(fileReadTool);
+ * server.registerTools([searchTool, weatherTool]);
+ *
+ * // Start serving
+ * await server.start();
+ * ```
+ */
+export declare class MCPServer {
+    private server;
+    private config;
+    private tools;
+    private started;
+    constructor(config: MCPServerConfig);
+    /**
+     * Register a single Cogitator tool
+     */
+    registerTool(tool: Tool): void;
+    /**
+     * Register multiple Cogitator tools
+     */
+    registerTools(tools: Tool[]): void;
+    /**
+     * Unregister a tool by name
+     */
+    unregisterTool(name: string): boolean;
+    /**
+     * Get list of registered tool names
+     */
+    getRegisteredTools(): string[];
+    /**
+     * Register a tool with the MCP server
+     */
+    private registerMCPTool;
+    /**
+     * Build the input schema for MCP tool registration
+     */
+    private buildInputSchema;
+    /**
+     * Execute a tool and return MCP-formatted result
+     */
+    private executeTool;
+    /**
+     * Start the MCP server
+     */
+    start(): Promise<void>;
+    /**
+     * Start HTTP server for MCP
+     */
+    private startHttpServer;
+    /**
+     * Stop the server
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if server is running
+     */
+    isRunning(): boolean;
+}
+/**
+ * Create and start an MCP server with the given tools
+ *
+ * @example
+ * ```typescript
+ * await serveMCPTools([calculator, datetime], {
+ *   name: 'my-tools',
+ *   version: '1.0.0',
+ *   transport: 'stdio',
+ * });
+ * ```
+ */
+export declare function serveMCPTools(tools: Tool[], config: MCPServerConfig): Promise<MCPServer>;
+//# sourceMappingURL=mcp-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/server/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAe,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAShD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,eAAe;IAQnC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAS9B;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAMlC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;YACW,WAAW;IAsDzB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC5B;;OAEG;YACW,eAAe;IAkD7B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B;;OAEG;IACH,SAAS,IAAI,OAAO;CAGrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,IAAI,EAAE,EACb,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,SAAS,CAAC,CAKpB"}