@mondaydotcomorg/atp-mcp-adapter 0.17.14

package/README.md

@@ -0,0 +1,407 @@
+# @mondaydotcomorg/atp-mcp-adapter
+
+Model Context Protocol (MCP) adapter for Agent Tool Protocol - connect MCP servers and use their tools in ATP.
+
+## Overview
+
+This package enables seamless integration between MCP (Model Context Protocol) servers and ATP servers. Connect to any MCP server (stdio or HTTP) and expose their tools as ATP APIs.
+
+## Installation
+
+```bash
+npm install @mondaydotcomorg/atp-mcp-adapter
+```
+
+## Architecture
+
+```mermaid
+graph LR
+    ATP[ATP Server] --> Adapter[MCP Adapter]
+    Adapter --> Stdio[StdioTransport]
+    Adapter --> HTTP[HTTPTransport]
+
+    Stdio --> MCP1[MCP Server 1<br/>Filesystem]
+    HTTP --> MCP2[MCP Server 2<br/>Database]
+    HTTP --> MCP3[MCP Server 3<br/>API]
+```
+
+## Quick Start
+
+### Connect to MCP Server (stdio)
+
+```typescript
+import { createServer } from '@mondaydotcomorg/atp-server';
+import { MCPConnector } from '@mondaydotcomorg/atp-mcp-adapter';
+
+const server = createServer();
+const mcpConnector = new MCPConnector();
+
+// Connect to filesystem MCP server
+const filesystemAPI = await mcpConnector.connectToMCPServer({
+	name: 'filesystem',
+	command: 'npx',
+	args: ['-y', '@modelcontextprotocol/server-filesystem', '/path/to/files'],
+	env: {
+		LOG_LEVEL: 'info',
+	},
+});
+
+server.addAPIGroup(filesystemAPI);
+
+await server.start(3333);
+
+// Agents can now use MCP tools:
+// await atp.api.filesystem.read_file({ path: 'README.md' })
+// await atp.api.filesystem.write_file({ path: 'file.txt', content: 'Hello' })
+```
+
+### Connect to HTTP MCP Server
+
+```typescript
+import { MCPHttpConnector } from '@mondaydotcomorg/atp-mcp-adapter';
+
+const httpConnector = new MCPHttpConnector();
+
+const databaseAPI = await httpConnector.connectToHttpServer({
+	name: 'database',
+	baseUrl: 'http://localhost:8080/mcp',
+	headers: {
+		Authorization: 'Bearer token',
+	},
+});
+
+server.addAPIGroup(databaseAPI);
+
+// Agents can use:
+// await atp.api.database.query({ sql: 'SELECT * FROM users' })
+```
+
+### Multiple MCP Servers
+
+```typescript
+const mcpConnector = new MCPConnector();
+
+const apis = await mcpConnector.connectToMultipleServers([
+	{
+		name: 'filesystem',
+		command: 'npx',
+		args: ['-y', '@modelcontextprotocol/server-filesystem', '/data'],
+	},
+	{
+		name: 'git',
+		command: 'npx',
+		args: ['-y', '@modelcontextprotocol/server-git', '/repo'],
+	},
+	{
+		name: 'database',
+		command: 'npx',
+		args: ['-y', '@modelcontextprotocol/server-postgres'],
+		env: {
+			DATABASE_URL: process.env.DATABASE_URL,
+		},
+	},
+]);
+
+apis.forEach((api) => server.addAPIGroup(api));
+
+// Agents can now use:
+// - atp.api.filesystem.*
+// - atp.api.git.*
+// - atp.api.database.*
+```
+
+## MCP Connectors
+
+### MCPConnector (stdio)
+
+Connect to MCP servers running as child processes via stdio.
+
+```typescript
+import { MCPConnector } from '@mondaydotcomorg/atp-mcp-adapter';
+
+const connector = new MCPConnector();
+
+const apiGroup = await connector.connectToMCPServer({
+  name: string;         // API group name
+  command: string;      // Command to execute
+  args: string[];       // Command arguments
+  env?: Record<string, string>;  // Environment variables
+});
+```
+
+**Examples:**
+
+```typescript
+// Filesystem MCP server
+const filesystem = await connector.connectToMCPServer({
+	name: 'files',
+	command: 'npx',
+	args: ['-y', '@modelcontextprotocol/server-filesystem', '/data'],
+});
+
+// Custom Python MCP server
+const custom = await connector.connectToMCPServer({
+	name: 'custom',
+	command: 'python',
+	args: ['mcp_server.py'],
+	env: {
+		API_KEY: process.env.API_KEY,
+	},
+});
+```
+
+### MCPHttpConnector
+
+Connect to MCP servers over HTTP.
+
+```typescript
+import { MCPHttpConnector } from '@mondaydotcomorg/atp-mcp-adapter';
+
+const connector = new MCPHttpConnector();
+
+const apiGroup = await connector.connectToHttpServer({
+  name: string;         // API group name
+  baseUrl: string;      // MCP server URL
+  headers?: Record<string, string>;  // HTTP headers
+});
+```
+
+**Example:**
+
+```typescript
+const api = await connector.connectToHttpServer({
+	name: 'remote-api',
+	baseUrl: 'https://mcp.example.com',
+	headers: {
+		Authorization: 'Bearer token',
+		'X-API-Key': process.env.API_KEY,
+	},
+});
+```
+
+## Tool Conversion
+
+MCP tools are automatically converted to ATP format:
+
+```typescript
+// MCP tool definition
+{
+  name: 'read_file',
+  description: 'Read file contents',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      path: { type: 'string' }
+    },
+    required: ['path']
+  }
+}
+
+// Converted to ATP function
+{
+  name: 'read_file',
+  description: 'Read file contents',
+  inputSchema: { /* same schema */ },
+  handler: async (input) => {
+    // Calls MCP server
+    const result = await mcpClient.callTool({
+      name: 'read_file',
+      arguments: input
+    });
+    return result.content;
+  }
+}
+```
+
+## Agent Usage
+
+Once MCP servers are connected, agents can use their tools naturally:
+
+```typescript
+// Agent-generated code
+const files = await atp.api.filesystem.list_directory({
+	path: '/data',
+});
+
+atp.log.info('Found files', { count: files.length });
+
+for (const file of files) {
+	const content = await atp.api.filesystem.read_file({
+		path: file.path,
+	});
+
+	// Process with LLM
+	const summary = await atp.llm.call({
+		prompt: `Summarize this file: ${content}`,
+	});
+
+	// Write summary
+	await atp.api.filesystem.write_file({
+		path: `${file.path}.summary`,
+		content: summary,
+	});
+}
+```
+
+## MCP Server Examples
+
+### Official MCP Servers
+
+```typescript
+// Filesystem
+await connector.connectToMCPServer({
+	name: 'filesystem',
+	command: 'npx',
+	args: ['-y', '@modelcontextprotocol/server-filesystem', '/path'],
+});
+
+// Git
+await connector.connectToMCPServer({
+	name: 'git',
+	command: 'npx',
+	args: ['-y', '@modelcontextprotocol/server-git', '/repo'],
+});
+
+// PostgreSQL
+await connector.connectToMCPServer({
+	name: 'postgres',
+	command: 'npx',
+	args: ['-y', '@modelcontextprotocol/server-postgres'],
+	env: {
+		DATABASE_URL: process.env.DATABASE_URL,
+	},
+});
+
+// Puppeteer (browser automation)
+await connector.connectToMCPServer({
+	name: 'browser',
+	command: 'npx',
+	args: ['-y', '@modelcontextprotocol/server-puppeteer'],
+});
+```
+
+### Custom MCP Server
+
+Create your own MCP server:
+
+```python
+# mcp_server.py
+from mcp.server import Server, Tool
+
+server = Server("custom-mcp-server")
+
+@server.tool()
+async def process_data(data: str) -> dict:
+    """Process data and return result"""
+    result = perform_processing(data)
+    return {"result": result}
+
+if __name__ == "__main__":
+    server.run()
+```
+
+Connect in ATP:
+
+```typescript
+await connector.connectToMCPServer({
+	name: 'custom',
+	command: 'python',
+	args: ['mcp_server.py'],
+});
+```
+
+## Error Handling
+
+```typescript
+try {
+	const api = await connector.connectToMCPServer({
+		name: 'filesystem',
+		command: 'npx',
+		args: ['-y', '@modelcontextprotocol/server-filesystem', '/path'],
+	});
+	server.addAPIGroup(api);
+} catch (error) {
+	console.error('Failed to connect to MCP server:', error);
+	// Handle connection error
+}
+```
+
+## Lifecycle Management
+
+```typescript
+const connector = new MCPConnector();
+
+// Connect
+const api = await connector.connectToMCPServer(config);
+
+// List connected servers
+const servers = connector.listServers();
+// Returns: ['filesystem', 'git', 'database']
+
+// Close specific server
+await connector.closeServer('filesystem');
+
+// Close all servers
+await connector.closeAll();
+```
+
+## Types
+
+```typescript
+interface MCPServerConfig {
+	name: string;
+	command: string;
+	args: string[];
+	env?: Record<string, string>;
+}
+
+interface MCPHttpConfig {
+	name: string;
+	baseUrl: string;
+	headers?: Record<string, string>;
+}
+
+interface MCPTool {
+	name: string;
+	description?: string;
+	inputSchema: {
+		type: string;
+		properties?: Record<string, unknown>;
+		required?: string[];
+	};
+}
+```
+
+## Integration Flow
+
+```mermaid
+sequenceDiagram
+    participant Agent
+    participant ATP Server
+    participant MCP Adapter
+    participant MCP Server
+
+    Agent->>ATP Server: execute(code with atp.api.filesystem.read_file())
+    ATP Server->>MCP Adapter: Call function
+    MCP Adapter->>MCP Server: MCP request
+    MCP Server-->>MCP Adapter: MCP response
+    MCP Adapter-->>ATP Server: Converted result
+    ATP Server-->>Agent: Execution result
+```
+
+## Benefits
+
+- ✅ **Zero modifications** to existing MCP servers
+- ✅ **Automatic tool discovery** and conversion
+- ✅ **Type-safe** integration with ATP
+- ✅ **Support for stdio and HTTP** transports
+- ✅ **Multiple server connections** in single ATP server
+- ✅ **Error handling** and lifecycle management
+
+## TypeScript Support
+
+Full TypeScript definitions included.
+
+## License
+
+MIT

package/dist/http-connector.d.ts

@@ -0,0 +1,18 @@
+import type { MCPTool, MCPPrompt } from './types.js';
+export declare class MCPHttpConnector {
+    private baseUrl;
+    private headers;
+    constructor(baseUrl: string, headers?: Record<string, string>);
+    private makeRequest;
+    listTools(): Promise<MCPTool[]>;
+    listPrompts(): Promise<MCPPrompt[]>;
+    getPrompt(name: string, args?: Record<string, string>): Promise<{
+        messages: Array<{
+            role: string;
+            content: string;
+        }>;
+    }>;
+    callTool(name: string, input: Record<string, unknown>): Promise<unknown>;
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=http-connector.d.ts.map

package/dist/http-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-connector.d.ts","sourceRoot":"","sources":["../src/http-connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAarD,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAyB;gBAE5B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;YAQnD,WAAW;IAmCnB,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAK/B,WAAW,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IASnC,SAAS,CACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,OAAO,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAc5D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IA4BxE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CACjC"}

package/dist/http-connector.js

@@ -0,0 +1,86 @@
+export class MCPHttpConnector {
+    baseUrl;
+    headers;
+    constructor(baseUrl, headers = {}) {
+        this.baseUrl = baseUrl.replace(/\/$/, '');
+        this.headers = {
+            'Content-Type': 'application/json',
+            ...headers,
+        };
+    }
+    async makeRequest(method, params) {
+        const body = {
+            jsonrpc: '2.0',
+            id: Date.now(),
+            method,
+        };
+        if (params) {
+            body.params = params;
+        }
+        const response = await fetch(this.baseUrl, {
+            method: 'POST',
+            headers: this.headers,
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        const data = (await response.json());
+        if (data.error) {
+            throw new Error(`MCP Error: ${data.error.message || JSON.stringify(data.error)}`);
+        }
+        return data.result;
+    }
+    async listTools() {
+        const result = (await this.makeRequest('tools/list'));
+        return result.tools || [];
+    }
+    async listPrompts() {
+        try {
+            const result = (await this.makeRequest('prompts/list'));
+            return result.prompts || [];
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    async getPrompt(name, args) {
+        const result = (await this.makeRequest('prompts/get', {
+            name,
+            arguments: args,
+        }));
+        return {
+            messages: result.messages.map((msg) => ({
+                role: msg.role,
+                content: typeof msg.content === 'string' ? msg.content : msg.content.text,
+            })),
+        };
+    }
+    async callTool(name, input) {
+        const result = (await this.makeRequest('tools/call', {
+            name,
+            arguments: input,
+        }));
+        if (!result.content || result.content.length === 0) {
+            return null;
+        }
+        const firstBlock = result.content[0];
+        if (result.content.length === 1 && firstBlock && firstBlock.type === 'text') {
+            const text = firstBlock.text || '';
+            try {
+                return JSON.parse(text);
+            }
+            catch {
+                return text;
+            }
+        }
+        return result.content.map((block) => {
+            if (block.type === 'text') {
+                return block.text;
+            }
+            return block;
+        });
+    }
+    async disconnect() { }
+}
+//# sourceMappingURL=http-connector.js.map

package/dist/http-connector.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { MCPConnector } from './mcp-connector.js';
+export { MCPHttpConnector } from './http-connector.js';
+export type { MCPTool, MCPPrompt } from './types.js';
+//# 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,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { MCPConnector } from './mcp-connector.js';
+export { MCPHttpConnector } from './http-connector.js';
+//# 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,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/mcp-connector.d.ts

@@ -0,0 +1,57 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { APIGroupConfig } from '@mondaydotcomorg/atp-protocol';
+interface MCPServerConfig {
+    name: string;
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+}
+/**
+ * MCPConnector connects to MCP servers and converts their tools to Agent Tool Protocol format.
+ */
+export declare class MCPConnector {
+    private clients;
+    private currentClient;
+    private currentServerName;
+    /**
+     * Connects to an MCP server and retrieves its tools.
+     * @param config - MCP server configuration
+     * @returns APIGroupConfig with converted tools
+     */
+    connectToMCPServer(config: MCPServerConfig): Promise<APIGroupConfig>;
+    /**
+     * Connects to multiple MCP servers.
+     * @param configs - Array of MCP server configurations
+     * @returns Array of APIGroupConfig objects
+     */
+    connectToMultipleServers(configs: MCPServerConfig[]): Promise<APIGroupConfig[]>;
+    /**
+     * Disconnects from all MCP servers.
+     */
+    disconnectAll(): Promise<void>;
+    /**
+     * Gets a connected MCP client by name.
+     * @param name - Server name
+     * @returns MCP Client or undefined
+     */
+    getClient(name: string): Client | undefined;
+    /**
+     * Lists all tools from the currently connected MCP server.
+     * @returns Array of tools
+     */
+    listTools(): Promise<any[]>;
+    /**
+     * Lists all prompts from the currently connected MCP server.
+     * @returns Array of prompts
+     */
+    listPrompts(): Promise<any[]>;
+    /**
+     * Calls a tool on the currently connected MCP server.
+     * @param name - Tool name
+     * @param input - Tool input parameters
+     * @returns Tool execution result
+     */
+    callTool(name: string, input: Record<string, unknown>): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=mcp-connector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-connector.d.ts","sourceRoot":"","sources":["../src/mcp-connector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,+BAA+B,CAAC;AAEvF,UAAU,eAAe;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,iBAAiB,CAAuB;IAEhD;;;;OAIG;IACG,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAkE1E;;;;OAIG;IACG,wBAAwB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAIrF;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAUpC;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3C;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAQjC;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAYnC;;;;;OAKG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAU9E"}

package/dist/mcp-connector.js

@@ -0,0 +1,131 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+/**
+ * MCPConnector connects to MCP servers and converts their tools to Agent Tool Protocol format.
+ */
+export class MCPConnector {
+    clients = new Map();
+    currentClient = null;
+    currentServerName = null;
+    /**
+     * Connects to an MCP server and retrieves its tools.
+     * @param config - MCP server configuration
+     * @returns APIGroupConfig with converted tools
+     */
+    async connectToMCPServer(config) {
+        const transport = new StdioClientTransport({
+            command: config.command,
+            args: config.args,
+            env: config.env,
+        });
+        const client = new Client({
+            name: 'agent-tool-protocol-connector',
+            version: '1.0.0',
+        }, {
+            capabilities: {},
+        });
+        await client.connect(transport);
+        this.clients.set(config.name, client);
+        this.currentClient = client;
+        this.currentServerName = config.name;
+        const toolsResult = await client.listTools();
+        const tools = toolsResult.tools || [];
+        const functions = tools.map((tool) => {
+            const schema = tool.inputSchema;
+            const inputSchema = schema || { type: 'object', properties: {} };
+            if (!inputSchema.type) {
+                inputSchema.type = 'object';
+            }
+            return {
+                name: tool.name,
+                description: tool.description || `MCP tool: ${tool.name}`,
+                inputSchema: inputSchema,
+                handler: async (input) => {
+                    const result = await client.callTool({
+                        name: tool.name,
+                        arguments: input,
+                    });
+                    return result.content;
+                },
+            };
+        });
+        return {
+            name: config.name,
+            type: 'mcp',
+            functions,
+        };
+    }
+    /**
+     * Connects to multiple MCP servers.
+     * @param configs - Array of MCP server configurations
+     * @returns Array of APIGroupConfig objects
+     */
+    async connectToMultipleServers(configs) {
+        return Promise.all(configs.map((config) => this.connectToMCPServer(config)));
+    }
+    /**
+     * Disconnects from all MCP servers.
+     */
+    async disconnectAll() {
+        const disconnectPromises = Array.from(this.clients.values()).map(async (client) => {
+            try {
+                await client.close();
+            }
+            catch (error) { }
+        });
+        await Promise.all(disconnectPromises);
+        this.clients.clear();
+    }
+    /**
+     * Gets a connected MCP client by name.
+     * @param name - Server name
+     * @returns MCP Client or undefined
+     */
+    getClient(name) {
+        return this.clients.get(name);
+    }
+    /**
+     * Lists all tools from the currently connected MCP server.
+     * @returns Array of tools
+     */
+    async listTools() {
+        if (!this.currentClient) {
+            throw new Error('Not connected to any MCP server');
+        }
+        const toolsResult = await this.currentClient.listTools();
+        return toolsResult.tools || [];
+    }
+    /**
+     * Lists all prompts from the currently connected MCP server.
+     * @returns Array of prompts
+     */
+    async listPrompts() {
+        if (!this.currentClient) {
+            throw new Error('Not connected to any MCP server');
+        }
+        try {
+            const promptsResult = await this.currentClient.listPrompts();
+            return promptsResult.prompts || [];
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    /**
+     * Calls a tool on the currently connected MCP server.
+     * @param name - Tool name
+     * @param input - Tool input parameters
+     * @returns Tool execution result
+     */
+    async callTool(name, input) {
+        if (!this.currentClient) {
+            throw new Error('Not connected to any MCP server');
+        }
+        const result = await this.currentClient.callTool({
+            name,
+            arguments: input,
+        });
+        return result.content;
+    }
+}
+//# sourceMappingURL=mcp-connector.js.map

package/dist/mcp-connector.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared types for MCP Adapter
+ */
+export interface MCPTool {
+    name: string;
+    description?: string;
+    inputSchema: {
+        type: string;
+        properties?: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export interface MCPPrompt {
+    name: string;
+    description?: string;
+    arguments?: Array<{
+        name: string;
+        description?: string;
+        required?: boolean;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACF;AAED,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;CACH"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for MCP Adapter
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,44 @@
+{
+	"name": "@mondaydotcomorg/atp-mcp-adapter",
+	"version": "0.17.14",
+	"description": "MCP compatibility adapter for Agent Tool Protocol",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"src"
+	],
+	"scripts": {
+		"build": "tsc -p tsconfig.json",
+		"dev": "tsc -p tsconfig.json --watch",
+		"clean": "rm -rf dist *.tsbuildinfo",
+		"test": "vitest run",
+		"lint": "tsc --noEmit"
+	},
+	"keywords": [
+		"agent",
+		"protocol",
+		"mcp",
+		"adapter",
+		"ai",
+		"llm"
+	],
+	"license": "MIT",
+	"dependencies": {
+		"@modelcontextprotocol/sdk": "^0.5.0",
+		"@mondaydotcomorg/atp-protocol": "0.17.14",
+		"@mondaydotcomorg/atp-server": "0.17.14",
+		"zod": "^4.1.11"
+	},
+	"devDependencies": {
+		"typescript": "^5.3.3",
+		"vitest": "^1.2.1"
+	}
+}

package/src/http-connector.ts

@@ -0,0 +1,121 @@
+import type { MCPTool, MCPPrompt } from './types.js';
+
+interface JsonRpcResponse {
+	jsonrpc: string;
+	id: number;
+	result?: unknown;
+	error?: {
+		code?: number;
+		message?: string;
+		data?: unknown;
+	};
+}
+
+export class MCPHttpConnector {
+	private baseUrl: string;
+	private headers: Record<string, string>;
+
+	constructor(baseUrl: string, headers: Record<string, string> = {}) {
+		this.baseUrl = baseUrl.replace(/\/$/, '');
+		this.headers = {
+			'Content-Type': 'application/json',
+			...headers,
+		};
+	}
+
+	private async makeRequest(method: string, params?: unknown): Promise<unknown> {
+		const body: {
+			jsonrpc: string;
+			id: number;
+			method: string;
+			params?: unknown;
+		} = {
+			jsonrpc: '2.0',
+			id: Date.now(),
+			method,
+		};
+
+		if (params) {
+			body.params = params;
+		}
+
+		const response = await fetch(this.baseUrl, {
+			method: 'POST',
+			headers: this.headers,
+			body: JSON.stringify(body),
+		});
+
+		if (!response.ok) {
+			throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+		}
+
+		const data = (await response.json()) as JsonRpcResponse;
+
+		if (data.error) {
+			throw new Error(`MCP Error: ${data.error.message || JSON.stringify(data.error)}`);
+		}
+
+		return data.result;
+	}
+
+	async listTools(): Promise<MCPTool[]> {
+		const result = (await this.makeRequest('tools/list')) as { tools: MCPTool[] };
+		return result.tools || [];
+	}
+
+	async listPrompts(): Promise<MCPPrompt[]> {
+		try {
+			const result = (await this.makeRequest('prompts/list')) as { prompts: MCPPrompt[] };
+			return result.prompts || [];
+		} catch (error) {
+			return [];
+		}
+	}
+
+	async getPrompt(
+		name: string,
+		args?: Record<string, string>
+	): Promise<{ messages: Array<{ role: string; content: string }> }> {
+		const result = (await this.makeRequest('prompts/get', {
+			name,
+			arguments: args,
+		})) as { messages: Array<{ role: string; content: { type: string; text: string } | string }> };
+
+		return {
+			messages: result.messages.map((msg) => ({
+				role: msg.role,
+				content: typeof msg.content === 'string' ? msg.content : msg.content.text,
+			})),
+		};
+	}
+
+	async callTool(name: string, input: Record<string, unknown>): Promise<unknown> {
+		const result = (await this.makeRequest('tools/call', {
+			name,
+			arguments: input,
+		})) as { content: Array<{ type: string; text?: string; data?: string; mimeType?: string }> };
+
+		if (!result.content || result.content.length === 0) {
+			return null;
+		}
+
+		const firstBlock = result.content[0];
+		if (result.content.length === 1 && firstBlock && firstBlock.type === 'text') {
+			const text = firstBlock.text || '';
+			try {
+				return JSON.parse(text);
+			} catch {
+				return text;
+			}
+		}
+
+		return result.content.map((block) => {
+			if (block.type === 'text') {
+				return block.text;
+			}
+			return block;
+		});
+	}
+
+	async disconnect(): Promise<void> {}
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export { MCPConnector } from './mcp-connector.js';
+export { MCPHttpConnector } from './http-connector.js';
+export type { MCPTool, MCPPrompt } from './types.js';

package/src/mcp-connector.ts

@@ -0,0 +1,166 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import type { APIGroupConfig, CustomFunctionDef } from '@mondaydotcomorg/atp-protocol';
+
+interface MCPServerConfig {
+	name: string;
+	command: string;
+	args: string[];
+	env?: Record<string, string>;
+}
+
+/**
+ * MCPConnector connects to MCP servers and converts their tools to Agent Tool Protocol format.
+ */
+export class MCPConnector {
+	private clients: Map<string, Client> = new Map();
+	private currentClient: Client | null = null;
+	private currentServerName: string | null = null;
+
+	/**
+	 * Connects to an MCP server and retrieves its tools.
+	 * @param config - MCP server configuration
+	 * @returns APIGroupConfig with converted tools
+	 */
+	async connectToMCPServer(config: MCPServerConfig): Promise<APIGroupConfig> {
+		const transport = new StdioClientTransport({
+			command: config.command,
+			args: config.args,
+			env: config.env,
+		});
+
+		const client = new Client(
+			{
+				name: 'agent-tool-protocol-connector',
+				version: '1.0.0',
+			},
+			{
+				capabilities: {},
+			}
+		);
+
+		await client.connect(transport);
+		this.clients.set(config.name, client);
+		this.currentClient = client;
+		this.currentServerName = config.name;
+
+		const toolsResult = await client.listTools();
+		const tools = toolsResult.tools || [];
+
+		const functions: CustomFunctionDef[] = tools.map(
+			(tool: { name: string; description?: string; inputSchema: unknown }) => {
+				const schema = tool.inputSchema as
+					| {
+							type?: string;
+							properties?: Record<string, any>;
+							required?: string[];
+					  }
+					| undefined;
+
+				const inputSchema = schema || { type: 'object', properties: {} };
+				if (!inputSchema.type) {
+					inputSchema.type = 'object';
+				}
+
+				return {
+					name: tool.name,
+					description: tool.description || `MCP tool: ${tool.name}`,
+					inputSchema: inputSchema as {
+						type: string;
+						properties?: Record<string, any>;
+						required?: string[];
+					},
+					handler: async (input: unknown) => {
+						const result = await client.callTool({
+							name: tool.name,
+							arguments: input as Record<string, unknown>,
+						});
+						return result.content;
+					},
+				};
+			}
+		);
+
+		return {
+			name: config.name,
+			type: 'mcp',
+			functions,
+		};
+	}
+
+	/**
+	 * Connects to multiple MCP servers.
+	 * @param configs - Array of MCP server configurations
+	 * @returns Array of APIGroupConfig objects
+	 */
+	async connectToMultipleServers(configs: MCPServerConfig[]): Promise<APIGroupConfig[]> {
+		return Promise.all(configs.map((config) => this.connectToMCPServer(config)));
+	}
+
+	/**
+	 * Disconnects from all MCP servers.
+	 */
+	async disconnectAll(): Promise<void> {
+		const disconnectPromises = Array.from(this.clients.values()).map(async (client) => {
+			try {
+				await client.close();
+			} catch (error) {}
+		});
+		await Promise.all(disconnectPromises);
+		this.clients.clear();
+	}
+
+	/**
+	 * Gets a connected MCP client by name.
+	 * @param name - Server name
+	 * @returns MCP Client or undefined
+	 */
+	getClient(name: string): Client | undefined {
+		return this.clients.get(name);
+	}
+
+	/**
+	 * Lists all tools from the currently connected MCP server.
+	 * @returns Array of tools
+	 */
+	async listTools(): Promise<any[]> {
+		if (!this.currentClient) {
+			throw new Error('Not connected to any MCP server');
+		}
+		const toolsResult = await this.currentClient.listTools();
+		return toolsResult.tools || [];
+	}
+
+	/**
+	 * Lists all prompts from the currently connected MCP server.
+	 * @returns Array of prompts
+	 */
+	async listPrompts(): Promise<any[]> {
+		if (!this.currentClient) {
+			throw new Error('Not connected to any MCP server');
+		}
+		try {
+			const promptsResult = await this.currentClient.listPrompts();
+			return promptsResult.prompts || [];
+		} catch (error) {
+			return [];
+		}
+	}
+
+	/**
+	 * Calls a tool on the currently connected MCP server.
+	 * @param name - Tool name
+	 * @param input - Tool input parameters
+	 * @returns Tool execution result
+	 */
+	async callTool(name: string, input: Record<string, unknown>): Promise<unknown> {
+		if (!this.currentClient) {
+			throw new Error('Not connected to any MCP server');
+		}
+		const result = await this.currentClient.callTool({
+			name,
+			arguments: input,
+		});
+		return result.content;
+	}
+}

package/src/types.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared types for MCP Adapter
+ */
+
+export interface MCPTool {
+	name: string;
+	description?: string;
+	inputSchema: {
+		type: string;
+		properties?: Record<string, unknown>;
+		required?: string[];
+	};
+}
+
+export interface MCPPrompt {
+	name: string;
+	description?: string;
+	arguments?: Array<{
+		name: string;
+		description?: string;
+		required?: boolean;
+	}>;
+}