snow-flow 1.1.4 → 1.1.14

package/manual-register-mcp.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+
+/**
+ * Manual MCP Registration Script for Snow-Flow
+ * Run this to register Snow-Flow MCP servers with Claude Desktop
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// Claude Desktop config path on macOS
+const CLAUDE_CONFIG_PATH = path.join(
+  os.homedir(),
+  'Library',
+  'Application Support',
+  'Claude',
+  'claude_desktop_config.json'
+);
+
+// Determine Snow-Flow installation path
+const SNOW_FLOW_PATH = '/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow';
+
+// Snow-Flow MCP servers configuration
+const SNOW_FLOW_SERVERS = {
+  "snow-flow-operations": {
+    "command": "node",
+    "args": [`${SNOW_FLOW_PATH}/dist/mcp/servicenow-operations-mcp.js`]
+  },
+  "snow-flow-automation": {
+    "command": "node",
+    "args": [`${SNOW_FLOW_PATH}/dist/mcp/servicenow-automation-mcp.js`]
+  },
+  "snow-flow-integration": {
+    "command": "node",
+    "args": [`${SNOW_FLOW_PATH}/dist/mcp/servicenow-integration-mcp.js`]
+  },
+  "snow-flow-deployment": {
+    "command": "node",
+    "args": [`${SNOW_FLOW_PATH}/dist/mcp/servicenow-deployment-mcp.js`]
+  },
+  "snow-flow-platform-development": {
+    "command": "node",
+    "args": [`${SNOW_FLOW_PATH}/dist/mcp/servicenow-platform-development-mcp.js`]
+  },
+  "snow-flow-reporting-analytics": {
+    "command": "node",
+    "args": [`${SNOW_FLOW_PATH}/dist/mcp/servicenow-reporting-analytics-mcp.js`]
+  },
+  "snow-flow-security-compliance": {
+    "command": "node",
+    "args": [`${SNOW_FLOW_PATH}/dist/mcp/servicenow-security-compliance-mcp.js`]
+  },
+  "snow-flow-flow-composer": {
+    "command": "node",
+    "args": [`${SNOW_FLOW_PATH}/dist/mcp/servicenow-flow-composer-mcp.js`]
+  },
+  "snow-flow-update-set": {
+    "command": "node",
+    "args": [`${SNOW_FLOW_PATH}/dist/mcp/servicenow-update-set-mcp.js`]
+  },
+  "snow-flow-intelligent": {
+    "command": "node",
+    "args": [`${SNOW_FLOW_PATH}/dist/mcp/servicenow-intelligent-mcp.js`]
+  },
+  "snow-flow-graph-memory": {
+    "command": "node",
+    "args": [`${SNOW_FLOW_PATH}/dist/mcp/servicenow-graph-memory-mcp.js`]
+  }
+};
+
+// Add environment variables if .env exists
+const envPath = path.join(SNOW_FLOW_PATH, '.env');
+if (fs.existsSync(envPath)) {
+  const envContent = fs.readFileSync(envPath, 'utf8');
+  const envVars = {};
+  
+  envContent.split('\n').forEach(line => {
+    const [key, value] = line.split('=');
+    if (key && value) {
+      envVars[key.trim()] = value.trim().replace(/^["']|["']$/g, '');
+    }
+  });
+  
+  // Add env vars to each server
+  Object.keys(SNOW_FLOW_SERVERS).forEach(serverKey => {
+    SNOW_FLOW_SERVERS[serverKey].env = envVars;
+  });
+}
+
+console.log('📋 Registering Snow-Flow MCP servers with Claude Desktop...\n');
+
+try {
+  // Read existing config
+  let config = { mcpServers: {} };
+  if (fs.existsSync(CLAUDE_CONFIG_PATH)) {
+    config = JSON.parse(fs.readFileSync(CLAUDE_CONFIG_PATH, 'utf8'));
+    if (!config.mcpServers) {
+      config.mcpServers = {};
+    }
+  }
+  
+  // Add Snow-Flow servers
+  let addedCount = 0;
+  Object.keys(SNOW_FLOW_SERVERS).forEach(key => {
+    if (!config.mcpServers[key]) {
+      config.mcpServers[key] = SNOW_FLOW_SERVERS[key];
+      addedCount++;
+      console.log(`✅ Added ${key}`);
+    } else {
+      console.log(`⏭️  ${key} already exists`);
+    }
+  });
+  
+  // Write updated config
+  fs.writeFileSync(CLAUDE_CONFIG_PATH, JSON.stringify(config, null, 2));
+  
+  console.log(`\n📝 Updated Claude Desktop configuration`);
+  console.log(`   Added ${addedCount} new servers`);
+  console.log(`   Path: ${CLAUDE_CONFIG_PATH}`);
+  
+  console.log('\n🔄 Please restart Claude Desktop to load the MCP servers');
+  console.log('💡 Use /mcp in Claude to verify the servers are available');
+  
+  // Also create a proper .env file in Snow-Flow directory if needed
+  if (!fs.existsSync(envPath)) {
+    console.log('\n⚠️  No .env file found in Snow-Flow installation');
+    console.log('   Create one at: ' + envPath);
+    console.log('   With your ServiceNow credentials:');
+    console.log('   SNOW_INSTANCE=your-instance.service-now.com');
+    console.log('   SNOW_CLIENT_ID=your-client-id');
+    console.log('   SNOW_CLIENT_SECRET=your-client-secret');
+  }
+  
+} catch (error) {
+  console.error('❌ Error registering MCP servers:', error.message);
+  process.exit(1);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snow-flow",
-  "version": "1.1.4",
+  "version": "1.1.14",
   "description": "Multi-Agent ServiceNow Development Platform - Create, manage, and deploy ServiceNow artifacts using natural language and AI agents",
   "main": "dist/index.js",
   "type": "commonjs",

package/scripts/create-env.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+
+/**
+ * Create .env file for Snow-Flow
+ * This helps users set up their ServiceNow credentials
+ */
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout
+});
+
+function question(query) {
+  return new Promise(resolve => rl.question(query, resolve));
+}
+
+async function createEnvFile() {
+  console.log('🔧 Snow-Flow Environment Setup\n');
+  console.log('This will create a .env file with your ServiceNow credentials.\n');
+  
+  // Get ServiceNow instance
+  const instance = await question('ServiceNow instance (e.g., dev12345.service-now.com): ');
+  
+  // Get OAuth credentials
+  const clientId = await question('OAuth Client ID: ');
+  const clientSecret = await question('OAuth Client Secret: ');
+  
+  // Optional Neo4j settings
+  console.log('\n📊 Neo4j Configuration (optional - press Enter to skip)');
+  const neo4jUri = await question('Neo4j URI (default: bolt://localhost:7687): ') || 'bolt://localhost:7687';
+  const neo4jUser = await question('Neo4j username (default: neo4j): ') || 'neo4j';
+  const neo4jPassword = await question('Neo4j password (default: password): ') || 'password';
+  
+  // Create .env content
+  const envContent = `# ServiceNow OAuth Configuration
+SNOW_INSTANCE=${instance}
+SNOW_CLIENT_ID=${clientId}
+SNOW_CLIENT_SECRET=${clientSecret}
+
+# OAuth URLs (these are automatically generated)
+OAUTH_TOKEN_URL=https://${instance}/oauth_token.do
+OAUTH_REDIRECT_URI=http://localhost:3000/callback
+
+# Neo4j Configuration (optional - for Graph Memory MCP)
+NEO4J_URI=${neo4jUri}
+NEO4J_USER=${neo4jUser}
+NEO4J_PASSWORD=${neo4jPassword}
+
+# Environment
+NODE_ENV=production
+`;
+
+  // Determine where to save .env
+  const isGlobalInstall = __dirname.includes('node_modules/snow-flow') || 
+                         __dirname.includes('.nvm/versions/node');
+  
+  const envPath = isGlobalInstall 
+    ? path.join(__dirname, '..', '.env')
+    : path.join(process.cwd(), '.env');
+  
+  // Write .env file
+  fs.writeFileSync(envPath, envContent);
+  
+  console.log(`\n✅ Created .env file at: ${envPath}`);
+  console.log('🎉 Your ServiceNow credentials are now configured!');
+  console.log('\n💡 Next steps:');
+  console.log('   1. Run: snow-flow init');
+  console.log('   2. Run: snow-flow auth login');
+  console.log('   3. Use /mcp in Claude Code to access ServiceNow tools');
+  
+  rl.close();
+}
+
+// Run if called directly
+if (require.main === module) {
+  createEnvFile().catch(error => {
+    console.error('❌ Error creating .env file:', error.message);
+    process.exit(1);
+  });
+}
+
+module.exports = { createEnvFile };

package/scripts/register-mcp-servers.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+
+/**
+ * Register Snow-Flow MCP servers with Claude Desktop
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// Claude Code config path
+const CLAUDE_CONFIG_PATH = path.join(
+  os.homedir(),
+  '.claude',
+  'mcp_config.json'
+);
+
+// Snow-Flow MCP servers configuration
+const SNOW_FLOW_SERVERS = {
+  "snow-flow-operations": {
+    "command": "node",
+    "args": ["${SNOW_FLOW_PATH}/dist/mcp/servicenow-operations-mcp.js"]
+  },
+  "snow-flow-automation": {
+    "command": "node",
+    "args": ["${SNOW_FLOW_PATH}/dist/mcp/servicenow-automation-mcp.js"]
+  },
+  "snow-flow-integration": {
+    "command": "node",
+    "args": ["${SNOW_FLOW_PATH}/dist/mcp/servicenow-integration-mcp.js"]
+  },
+  "snow-flow-deployment": {
+    "command": "node",
+    "args": ["${SNOW_FLOW_PATH}/dist/mcp/servicenow-deployment-mcp.js"]
+  },
+  "snow-flow-platform-development": {
+    "command": "node",
+    "args": ["${SNOW_FLOW_PATH}/dist/mcp/servicenow-platform-development-mcp.js"]
+  },
+  "snow-flow-reporting-analytics": {
+    "command": "node",
+    "args": ["${SNOW_FLOW_PATH}/dist/mcp/servicenow-reporting-analytics-mcp.js"]
+  },
+  "snow-flow-security-compliance": {
+    "command": "node",
+    "args": ["${SNOW_FLOW_PATH}/dist/mcp/servicenow-security-compliance-mcp.js"]
+  },
+  "snow-flow-flow-composer": {
+    "command": "node",
+    "args": ["${SNOW_FLOW_PATH}/dist/mcp/servicenow-flow-composer-mcp.js"]
+  },
+  "snow-flow-update-set": {
+    "command": "node",
+    "args": ["${SNOW_FLOW_PATH}/dist/mcp/servicenow-update-set-mcp.js"]
+  },
+  "snow-flow-intelligent": {
+    "command": "node",
+    "args": ["${SNOW_FLOW_PATH}/dist/mcp/servicenow-intelligent-mcp.js"]
+  },
+  "snow-flow-graph-memory": {
+    "command": "node",
+    "args": ["${SNOW_FLOW_PATH}/dist/mcp/servicenow-graph-memory-mcp.js"]
+  }
+};
+
+async function registerMCPServers() {
+  try {
+    // Determine Snow-Flow installation path
+    const isGlobalInstall = __dirname.includes('node_modules/snow-flow') || 
+                           __dirname.includes('.nvm/versions/node');
+    
+    const snowFlowPath = process.env.SNOW_FLOW_PATH || 
+                        (isGlobalInstall ? path.resolve(__dirname, '..') : process.cwd());
+    
+    // Replace ${SNOW_FLOW_PATH} with actual path
+    const servers = JSON.parse(JSON.stringify(SNOW_FLOW_SERVERS));
+    Object.keys(servers).forEach(key => {
+      // Replace path placeholder
+      if (servers[key].args && servers[key].args[0]) {
+        servers[key].args[0] = servers[key].args[0].replace('${SNOW_FLOW_PATH}', snowFlowPath);
+      }
+      
+      // Add environment variables from .env if it exists
+      const envPath = path.join(snowFlowPath, '.env');
+      if (fs.existsSync(envPath)) {
+        try {
+          const envContent = fs.readFileSync(envPath, 'utf8');
+          const envVars = {};
+          
+          envContent.split('\n').forEach(line => {
+            // Skip comments and empty lines
+            if (line.trim() && !line.trim().startsWith('#')) {
+              const [key, ...valueParts] = line.split('=');
+              if (key && valueParts.length > 0) {
+                const value = valueParts.join('=').trim().replace(/^["']|["']$/g, '');
+                envVars[key.trim()] = value;
+              }
+            }
+          });
+          
+          // Add env vars to server config
+          if (Object.keys(envVars).length > 0) {
+            servers[key].env = envVars;
+          }
+        } catch (err) {
+          console.warn('⚠️  Could not read .env file:', err.message);
+        }
+      }
+    });
+
+    // Check if Claude config exists
+    if (!fs.existsSync(CLAUDE_CONFIG_PATH)) {
+      console.log('⚠️  Claude Code configuration not found.');
+      console.log('📍 Creating new configuration at:', CLAUDE_CONFIG_PATH);
+      
+      // Ensure directory exists
+      const configDir = path.dirname(CLAUDE_CONFIG_PATH);
+      if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+      }
+      
+      // Create new config with "servers" (not "mcpServers")
+      const newConfig = {
+        servers: servers
+      };
+      
+      fs.writeFileSync(CLAUDE_CONFIG_PATH, JSON.stringify(newConfig, null, 2));
+      console.log('✅ Created new Claude Code configuration with Snow-Flow MCP servers');
+    } else {
+      // Read existing config
+      let config = JSON.parse(fs.readFileSync(CLAUDE_CONFIG_PATH, 'utf8'));
+      
+      // Initialize servers if not exists (Claude Code uses "servers" not "mcpServers")
+      if (!config.servers) {
+        config.servers = {};
+      }
+      
+      // Add Snow-Flow servers
+      let addedCount = 0;
+      Object.keys(servers).forEach(key => {
+        if (!config.servers[key]) {
+          config.servers[key] = servers[key];
+          addedCount++;
+        }
+      });
+      
+      // Write updated config
+      fs.writeFileSync(CLAUDE_CONFIG_PATH, JSON.stringify(config, null, 2));
+      
+      if (addedCount > 0) {
+        console.log(`✅ Added ${addedCount} Snow-Flow MCP servers to Claude Code configuration`);
+      } else {
+        console.log('✅ All Snow-Flow MCP servers already registered');
+      }
+    }
+    
+    console.log('\n📋 Registered MCP servers:');
+    Object.keys(servers).forEach(key => {
+      console.log(`   - ${key}`);
+    });
+    
+    console.log('\n🔄 MCP servers are now available in Claude Code');
+    console.log('💡 Use /mcp in Claude Code to verify the servers are available');
+    
+  } catch (error) {
+    console.error('❌ Error registering MCP servers:', error.message);
+    process.exit(1);
+  }
+}
+
+// Run if called directly
+if (require.main === module) {
+  registerMCPServers();
+}
+
+module.exports = { registerMCPServers };

package/scripts/setup-mcp.js

@@ -7,9 +7,22 @@
 
 const fs = require('fs');
 const path = require('path');
-require('dotenv').config();
+// Try to load .env file if it exists, but don't fail if it doesn't
+try {
+  require('dotenv').config();
+} catch (err) {
+  // .env file not found, that's OK
+}
+
+// Determine if we're in a global npm installation
+const isGlobalInstall = __dirname.includes('node_modules/snow-flow') || 
+                       __dirname.includes('.nvm/versions/node');
+
+// For global installs, use the package directory, not cwd
+const projectRoot = isGlobalInstall 
+  ? path.resolve(__dirname, '..') // Go up from scripts/ to package root
+  : process.cwd();
 
-const projectRoot = process.cwd();
 const templatePath = path.join(projectRoot, '.mcp.json.template');
 const mcpFilePath = path.join(projectRoot, '.mcp.json');