mcpgraph 0.1.2 → 0.1.4

package/README.md

@@ -20,11 +20,13 @@ Here's a simple example that counts files in a directory:
 ```yaml
 version: "1.0"
 
+# MCP Server Metadata
 server:
-  name: "mcpGraph"
+  name: "fileUtils"
   version: "1.0.0"
-  description: "MCP server that executes directed graphs of MCP tool calls"
+  description: "File utilities"
 
+# Tool Definitions
 tools:
   - name: "count_files"
     description: "Counts the number of files in a directory"
@@ -42,22 +44,34 @@ tools:
         count:
           type: "number"
           description: "The number of files in the directory"
-    entryNode: "entry_count_files"
-    exitNode: "exit_count_files"
 
+# MCP Servers used by the graph
+servers:
+  filesystem:
+    command: "npx"
+    args:
+      - "-y"
+      - "@modelcontextprotocol/server-filesystem"
+      - "./tests/files"
+
+# Graph Nodes
 nodes:
+  # Entry node: Receives tool arguments
   - id: "entry_count_files"
     type: "entry"
+    tool: "count_files"
     next: "list_directory_node"
   
+  # List directory contents
   - id: "list_directory_node"
-    type: "mcp_tool"
+    type: "mcp"
     server: "filesystem"
     tool: "list_directory"
     args:
       path: "$.input.directory"
     next: "count_files_node"
   
+  # Transform and count files
   - id: "count_files_node"
     type: "transform"
     transform:
@@ -65,8 +79,10 @@ nodes:
         { "count": $count($split(list_directory_node, "\n")) }
     next: "exit_count_files"
   
+  # Exit node: Returns the count
   - id: "exit_count_files"
     type: "exit"
+    tool: "count_files"
 ```
 
 This graph:
@@ -78,7 +94,7 @@ This graph:
 ## Node Types
 
 - **`entry`**: Entry point for a tool's graph execution. Receives tool arguments.
-- **`mcp_tool`**: Calls an MCP tool on an internal or external MCP server.
+- **`mcp`**: Calls an MCP tool on an internal or external MCP server.
 - **`transform`**: Applies [JSONata](https://jsonata.org/) expressions to transform data between nodes.
 - **`switch`**: Uses [JSON Logic](https://jsonlogic.com/) to conditionally route to different nodes.
 - **`exit`**: Exit point that returns the final result to the MCP tool caller.
@@ -145,6 +161,30 @@ Or if not installed (run from npm):
 
 **Note:** Replace `/path/to/your/config.yaml` with the actual path to your YAML configuration file. The `-c` flag specifies the configuration file to use.
 
+### Programmatic API
+
+The `mcpgraph` package exports a programmatic API that can be used in your own applications (e.g., for building a UX server or other interfaces):
+
+```typescript
+import { McpGraphApi } from 'mcpgraph';
+
+// Create an API instance (loads and validates config)
+const api = new McpGraphApi('path/to/config.yaml');
+
+// List all available tools
+const tools = api.listTools();
+
+// Execute a tool
+const result = await api.executeTool('count_files', {
+  directory: './tests/files',
+});
+
+// Clean up resources
+await api.close();
+```
+
+See [`examples/api-usage.ts`](examples/api-usage.ts) for a complete example.
+
 ## Documentation
 
 - [Contributing Guide](CONTRIBUTING.md) - Setup, development, and contribution guidelines

package/dist/api.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Programmatic API for mcpGraph
+ *
+ * This API can be used by:
+ * - MCP server (main.ts) - for stdio transport
+ * - UX applications - for HTTP/WebSocket servers
+ * - Other applications - for programmatic graph execution
+ */
+import type { McpGraphConfig } from './types/config.js';
+import { type ValidationError } from './graph/validator.js';
+export interface ToolInfo {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+}
+export interface ExecutionResult {
+    result: unknown;
+    structuredContent?: Record<string, unknown>;
+}
+export declare class McpGraphApi {
+    private config;
+    private executor;
+    private clientManager;
+    /**
+     * Create a new McpGraphApi instance
+     * @param configPath - Path to the YAML configuration file
+     * @throws Error if config cannot be loaded or validated
+     */
+    constructor(configPath: string);
+    /**
+     * Get the server metadata
+     */
+    getServerInfo(): {
+        name: string;
+        version: string;
+        description: string;
+    };
+    /**
+     * List all available tools
+     */
+    listTools(): ToolInfo[];
+    /**
+     * Get information about a specific tool
+     */
+    getTool(toolName: string): ToolInfo | undefined;
+    /**
+     * Execute a tool with the given arguments
+     */
+    executeTool(toolName: string, toolArguments?: Record<string, unknown>): Promise<ExecutionResult>;
+    /**
+     * Get the full configuration
+     */
+    getConfig(): McpGraphConfig;
+    /**
+     * Validate a configuration without creating an API instance
+     */
+    static validateConfig(configPath: string): ValidationError[];
+    /**
+     * Load and validate a configuration without creating an API instance
+     */
+    static loadAndValidateConfig(configPath: string): {
+        config: McpGraphConfig;
+        errors: ValidationError[];
+    };
+    /**
+     * Clean up resources (close MCP clients, etc.)
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI3E,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,aAAa,CAAmB;IAExC;;;;OAIG;gBACS,UAAU,EAAE,MAAM;IAmB9B;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;IAQvE;;OAEG;IACH,SAAS,IAAI,QAAQ,EAAE;IASvB;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAc/C;;OAEG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAC1C,OAAO,CAAC,eAAe,CAAC;IAS3B;;OAEG;IACH,SAAS,IAAI,cAAc;IAI3B;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,EAAE;IAK5D;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG;QAChD,MAAM,EAAE,cAAc,CAAC;QACvB,MAAM,EAAE,eAAe,EAAE,CAAC;KAC3B;IAMD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/api.js

@@ -0,0 +1,111 @@
+/**
+ * Programmatic API for mcpGraph
+ *
+ * This API can be used by:
+ * - MCP server (main.ts) - for stdio transport
+ * - UX applications - for HTTP/WebSocket servers
+ * - Other applications - for programmatic graph execution
+ */
+import { logger } from './logger.js';
+import { loadConfig } from './config/loader.js';
+import { validateGraph } from './graph/validator.js';
+import { GraphExecutor } from './execution/executor.js';
+import { McpClientManager } from './mcp/client-manager.js';
+export class McpGraphApi {
+    config;
+    executor;
+    clientManager;
+    /**
+     * Create a new McpGraphApi instance
+     * @param configPath - Path to the YAML configuration file
+     * @throws Error if config cannot be loaded or validated
+     */
+    constructor(configPath) {
+        logger.info(`Loading configuration from: ${configPath}`);
+        const config = loadConfig(configPath);
+        const errors = validateGraph(config);
+        if (errors.length > 0) {
+            const errorMessages = errors.map((e) => e.message).join(', ');
+            throw new Error(`Graph validation failed: ${errorMessages}`);
+        }
+        this.config = config;
+        this.clientManager = new McpClientManager();
+        this.executor = new GraphExecutor(config, this.clientManager);
+        logger.info(`Loaded configuration: ${config.server.name} v${config.server.version}`);
+        logger.info(`Tools defined: ${config.tools.map(t => t.name).join(', ')}`);
+    }
+    /**
+     * Get the server metadata
+     */
+    getServerInfo() {
+        return {
+            name: this.config.server.name,
+            version: this.config.server.version,
+            description: this.config.server.description,
+        };
+    }
+    /**
+     * List all available tools
+     */
+    listTools() {
+        return this.config.tools.map(tool => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+            outputSchema: tool.outputSchema,
+        }));
+    }
+    /**
+     * Get information about a specific tool
+     */
+    getTool(toolName) {
+        const tool = this.config.tools.find(t => t.name === toolName);
+        if (!tool) {
+            return undefined;
+        }
+        return {
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+            outputSchema: tool.outputSchema,
+        };
+    }
+    /**
+     * Execute a tool with the given arguments
+     */
+    async executeTool(toolName, toolArguments = {}) {
+        const result = await this.executor.executeTool(toolName, toolArguments);
+        return {
+            result,
+            structuredContent: result,
+        };
+    }
+    /**
+     * Get the full configuration
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Validate a configuration without creating an API instance
+     */
+    static validateConfig(configPath) {
+        const config = loadConfig(configPath);
+        return validateGraph(config);
+    }
+    /**
+     * Load and validate a configuration without creating an API instance
+     */
+    static loadAndValidateConfig(configPath) {
+        const config = loadConfig(configPath);
+        const errors = validateGraph(config);
+        return { config, errors };
+    }
+    /**
+     * Clean up resources (close MCP clients, etc.)
+     */
+    async close() {
+        await this.clientManager.closeAll();
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/config/schema.d.ts

@@ -17,6 +17,55 @@ export declare const mcpGraphConfigSchema: z.ZodObject<{
         name: string;
         version: string;
     }>;
+    servers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodObject<{
+        type: z.ZodOptional<z.ZodLiteral<"stdio">>;
+        command: z.ZodString;
+        args: z.ZodArray<z.ZodString, "many">;
+        cwd: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        args: string[];
+        type?: "stdio" | undefined;
+        cwd?: string | undefined;
+    }, {
+        command: string;
+        args: string[];
+        type?: "stdio" | undefined;
+        cwd?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"sse">;
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        eventSourceInit: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        requestInit: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "sse";
+        url: string;
+        headers?: Record<string, string> | undefined;
+        eventSourceInit?: Record<string, unknown> | undefined;
+        requestInit?: Record<string, unknown> | undefined;
+    }, {
+        type: "sse";
+        url: string;
+        headers?: Record<string, string> | undefined;
+        eventSourceInit?: Record<string, unknown> | undefined;
+        requestInit?: Record<string, unknown> | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"streamableHttp">;
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        requestInit: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "streamableHttp";
+        url: string;
+        headers?: Record<string, string> | undefined;
+        requestInit?: Record<string, unknown> | undefined;
+    }, {
+        type: "streamableHttp";
+        url: string;
+        headers?: Record<string, string> | undefined;
+        requestInit?: Record<string, unknown> | undefined;
+    }>]>>>;
     tools: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         description: z.ZodString;
@@ -82,8 +131,6 @@ export declare const mcpGraphConfigSchema: z.ZodObject<{
             }> | undefined;
             required?: string[] | undefined;
         }>;
-        entryNode: z.ZodString;
-        exitNode: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         description: string;
         name: string;
@@ -105,8 +152,6 @@ export declare const mcpGraphConfigSchema: z.ZodObject<{
             }> | undefined;
             required?: string[] | undefined;
         };
-        entryNode: string;
-        exitNode: string;
     }, {
         description: string;
         name: string;
@@ -128,57 +173,61 @@ export declare const mcpGraphConfigSchema: z.ZodObject<{
             }> | undefined;
             required?: string[] | undefined;
         };
-        entryNode: string;
-        exitNode: string;
     }>, "many">;
     nodes: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         id: z.ZodString;
     } & {
         type: z.ZodLiteral<"entry">;
+        tool: z.ZodString;
         next: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         type: "entry";
         id: string;
         next: string;
+        tool: string;
     }, {
         type: "entry";
         id: string;
         next: string;
+        tool: string;
     }>, z.ZodObject<{
         id: z.ZodString;
         next: z.ZodOptional<z.ZodString>;
     } & {
         type: z.ZodLiteral<"exit">;
+        tool: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         type: "exit";
         id: string;
+        tool: string;
         next?: string | undefined;
     }, {
         type: "exit";
         id: string;
+        tool: string;
         next?: string | undefined;
     }>, z.ZodObject<{
         id: z.ZodString;
     } & {
-        type: z.ZodLiteral<"mcp_tool">;
+        type: z.ZodLiteral<"mcp">;
         server: z.ZodString;
         tool: z.ZodString;
         args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         next: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        type: "mcp_tool";
+        type: "mcp";
+        args: Record<string, unknown>;
         id: string;
         next: string;
-        server: string;
         tool: string;
-        args: Record<string, unknown>;
+        server: string;
     }, {
-        type: "mcp_tool";
+        type: "mcp";
+        args: Record<string, unknown>;
         id: string;
         next: string;
-        server: string;
         tool: string;
-        args: Record<string, unknown>;
+        server: string;
     }>, z.ZodObject<{
         id: z.ZodString;
     } & {
@@ -265,24 +314,24 @@ export declare const mcpGraphConfigSchema: z.ZodObject<{
             }> | undefined;
             required?: string[] | undefined;
         };
-        entryNode: string;
-        exitNode: string;
     }[];
     nodes: ({
         type: "entry";
         id: string;
         next: string;
+        tool: string;
     } | {
         type: "exit";
         id: string;
+        tool: string;
         next?: string | undefined;
     } | {
-        type: "mcp_tool";
+        type: "mcp";
+        args: Record<string, unknown>;
         id: string;
         next: string;
-        server: string;
         tool: string;
-        args: Record<string, unknown>;
+        server: string;
     } | {
         type: "transform";
         id: string;
@@ -299,6 +348,23 @@ export declare const mcpGraphConfigSchema: z.ZodObject<{
         }[];
         next?: string | undefined;
     })[];
+    servers?: Record<string, {
+        command: string;
+        args: string[];
+        type?: "stdio" | undefined;
+        cwd?: string | undefined;
+    } | {
+        type: "sse";
+        url: string;
+        headers?: Record<string, string> | undefined;
+        eventSourceInit?: Record<string, unknown> | undefined;
+        requestInit?: Record<string, unknown> | undefined;
+    } | {
+        type: "streamableHttp";
+        url: string;
+        headers?: Record<string, string> | undefined;
+        requestInit?: Record<string, unknown> | undefined;
+    }> | undefined;
 }, {
     version: string;
     server: {
@@ -327,24 +393,24 @@ export declare const mcpGraphConfigSchema: z.ZodObject<{
             }> | undefined;
             required?: string[] | undefined;
         };
-        entryNode: string;
-        exitNode: string;
     }[];
     nodes: ({
         type: "entry";
         id: string;
         next: string;
+        tool: string;
     } | {
         type: "exit";
         id: string;
+        tool: string;
         next?: string | undefined;
     } | {
-        type: "mcp_tool";
+        type: "mcp";
+        args: Record<string, unknown>;
         id: string;
         next: string;
-        server: string;
         tool: string;
-        args: Record<string, unknown>;
+        server: string;
     } | {
         type: "transform";
         id: string;
@@ -361,6 +427,23 @@ export declare const mcpGraphConfigSchema: z.ZodObject<{
         }[];
         next?: string | undefined;
     })[];
+    servers?: Record<string, {
+        command: string;
+        args: string[];
+        type?: "stdio" | undefined;
+        cwd?: string | undefined;
+    } | {
+        type: "sse";
+        url: string;
+        headers?: Record<string, string> | undefined;
+        eventSourceInit?: Record<string, unknown> | undefined;
+        requestInit?: Record<string, unknown> | undefined;
+    } | {
+        type: "streamableHttp";
+        url: string;
+        headers?: Record<string, string> | undefined;
+        requestInit?: Record<string, unknown> | undefined;
+    }> | undefined;
 }>;
 export type McpGraphConfigSchema = z.infer<typeof mcpGraphConfigSchema>;
 //# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8ExB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK/B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8GxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM/B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/config/schema.js

@@ -17,6 +17,34 @@ const serverMetadataSchema = z.object({
     version: z.string(),
     description: z.string(),
 });
+const stdioServerConfigSchema = z.object({
+    type: z.literal("stdio").optional(),
+    command: z.string(),
+    args: z.array(z.string()),
+    cwd: z.string().optional(),
+});
+const sseServerConfigSchema = z.object({
+    type: z.literal("sse"),
+    url: z.string(),
+    headers: z.record(z.string()).optional(),
+    eventSourceInit: z.record(z.unknown()).optional(),
+    requestInit: z.record(z.unknown()).optional(),
+});
+const streamableHttpServerConfigSchema = z.object({
+    type: z.literal("streamableHttp"),
+    url: z.string(),
+    headers: z.record(z.string()).optional(),
+    requestInit: z.record(z.unknown()).optional(),
+});
+// Server config can be stdio (with or without type), sse, or streamableHttp
+const serverConfigSchema = z.union([
+    // Stdio config (type optional, defaults to stdio)
+    stdioServerConfigSchema,
+    // SSE config (type required)
+    sseServerConfigSchema,
+    // Streamable HTTP config (type required)
+    streamableHttpServerConfigSchema,
+]);
 const baseNodeSchema = z.object({
     id: z.string(),
     type: z.string(),
@@ -24,13 +52,15 @@ const baseNodeSchema = z.object({
 });
 const entryNodeSchema = baseNodeSchema.extend({
     type: z.literal("entry"),
+    tool: z.string(),
     next: z.string(),
 });
 const exitNodeSchema = baseNodeSchema.extend({
     type: z.literal("exit"),
+    tool: z.string(),
 });
-const mcpToolNodeSchema = baseNodeSchema.extend({
-    type: z.literal("mcp_tool"),
+const mcpNodeSchema = baseNodeSchema.extend({
+    type: z.literal("mcp"),
     server: z.string(),
     tool: z.string(),
     args: z.record(z.unknown()),
@@ -54,7 +84,7 @@ const switchNodeSchema = baseNodeSchema.extend({
 const nodeSchema = z.discriminatedUnion("type", [
     entryNodeSchema,
     exitNodeSchema,
-    mcpToolNodeSchema,
+    mcpNodeSchema,
     transformNodeSchema,
     switchNodeSchema,
 ]);
@@ -63,12 +93,11 @@ const toolDefinitionSchema = z.object({
     description: z.string(),
     inputSchema: jsonSchemaSchema,
     outputSchema: jsonSchemaSchema,
-    entryNode: z.string(),
-    exitNode: z.string(),
 });
 export const mcpGraphConfigSchema = z.object({
     version: z.string(),
     server: serverMetadataSchema,
+    servers: z.record(serverConfigSchema).optional(),
     tools: z.array(toolDefinitionSchema),
     nodes: z.array(nodeSchema),
 });

package/dist/config/schema.js.map

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

package/dist/execution/executor.d.ts

@@ -8,6 +8,7 @@ export declare class GraphExecutor {
     private graph;
     private clientManager;
     constructor(config: McpGraphConfig, clientManager: McpClientManager);
+    private getServerConfig;
     executeTool(toolName: string, toolInput: Record<string, unknown>): Promise<unknown>;
 }
 //# sourceMappingURL=executor.d.ts.map

package/dist/execution/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/execution/executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,oBAAoB,CAAC;AAQzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,aAAa,CAAmB;gBAE5B,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB;IAM7D,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,OAAO,CAAC;CA0DpB"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/execution/executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAgC,MAAM,oBAAoB,CAAC;AAQvF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,aAAa,CAAmB;gBAE5B,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB;IAMnE,OAAO,CAAC,eAAe;IAOjB,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,OAAO,CAAC;CA2EpB"}