mcpgraph 0.1.2 → 0.1.4

package/examples/api-usage.ts

@@ -0,0 +1,69 @@
+/**
+ * Example: Using the mcpGraph API programmatically
+ * 
+ * This example shows how to use the McpGraphApi class in your own applications,
+ * such as a UX server or other programmatic interface.
+ */
+
+import { McpGraphApi } from '../src/api.js';
+
+async function example() {
+  // Create an API instance (loads and validates config)
+  const api = new McpGraphApi('examples/count_files.yaml');
+
+  // Get server information
+  const serverInfo = api.getServerInfo();
+  console.log(`Server: ${serverInfo.name} v${serverInfo.version}`);
+
+  // List all available tools
+  const tools = api.listTools();
+  console.log(`Available tools: ${tools.map(t => t.name).join(', ')}`);
+
+  // Get information about a specific tool
+  const toolInfo = api.getTool('count_files');
+  if (toolInfo) {
+    console.log(`Tool: ${toolInfo.name}`);
+    console.log(`Description: ${toolInfo.description}`);
+  }
+
+  // Execute a tool
+  const result = await api.executeTool('count_files', {
+    directory: './tests/files',
+  });
+
+  console.log('Execution result:', result.result);
+  console.log('Structured content:', result.structuredContent);
+
+  // Clean up resources
+  await api.close();
+}
+
+// Example: Validate config without creating an API instance
+function validateConfigExample() {
+  const errors = McpGraphApi.validateConfig('examples/count_files.yaml');
+  if (errors.length > 0) {
+    console.error('Validation errors:');
+    for (const error of errors) {
+      console.error(`  - ${error.message}`);
+    }
+  } else {
+    console.log('Config is valid!');
+  }
+}
+
+// Example: Load and validate config
+function loadAndValidateExample() {
+  const { config, errors } = McpGraphApi.loadAndValidateConfig('examples/count_files.yaml');
+  if (errors.length > 0) {
+    console.error('Validation errors:', errors);
+  } else {
+    console.log('Config loaded successfully');
+    console.log(`Tools: ${config.tools.map(t => t.name).join(', ')}`);
+  }
+}
+
+// Run examples
+if (import.meta.url === `file://${process.argv[1]}`) {
+  example().catch(console.error);
+}
+

package/examples/count_files.yaml

@@ -2,9 +2,9 @@ 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:
@@ -24,19 +24,36 @@ 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:
+  # Stdio server (type is optional, defaults to stdio)
+  filesystem:
+    command: "npx"
+    args:
+      - "-y"
+      - "@modelcontextprotocol/server-filesystem"
+      - "/Users/bob/Documents/GitHub/mcpGraph/tests/files"
+  
+  # Example: Streamable HTTP server (preferred for HTTP/SSE)
+  # httpServer:
+  #   type: "streamableHttp"
+  #   url: "https://api.example.com/mcp"
+  #   headers:
+  #     Authorization: "Bearer token"
+  #     X-Custom-Header: "value"
 
 # 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:
@@ -54,4 +71,5 @@ nodes:
   # Exit node: Returns the count
   - id: "exit_count_files"
     type: "exit"
+    tool: "count_files"
 

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "mcpgraph",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "MCP server that executes directed graphs of MCP server calls",
   "main": "dist/main.js",
   "type": "module",
+  "exports": {
+    ".": "./dist/api.js",
+    "./api": "./dist/api.js"
+  },
   "bin": {
     "mcpgraph": "./dist/main.js"
   },