@nihalcastelino/project-brain-mcp 1.0.0

package/publish-auto.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+
+/**
+ * Automated npm Publish Script
+ * Uses NPM_TOKEN from .env for authentication
+ */
+
+import { spawn } from 'child_process';
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+console.log("🚀 Automated npm Publish for Project Brain MCP\n");
+
+// Load .env file
+function loadEnv() {
+  const envPath = '.env';
+  if (!existsSync(envPath)) {
+    console.error("❌ Error: .env file not found!");
+    console.error("\nCreate .env file and add:");
+    console.error("NPM_TOKEN=your_npm_access_token_here\n");
+    process.exit(1);
+  }
+
+  const envContent = readFileSync(envPath, 'utf8');
+  const lines = envContent.split('\n');
+
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (trimmed && !trimmed.startsWith('#')) {
+      const [key, ...valueParts] = trimmed.split('=');
+      const value = valueParts.join('=').trim();
+      if (key === 'NPM_TOKEN') {
+        return value;
+      }
+    }
+  }
+
+  return null;
+}
+
+// Get npm token
+const npmToken = loadEnv();
+
+if (!npmToken || npmToken === 'YOUR_NPM_ACCESS_TOKEN_HERE') {
+  console.error("❌ Error: NPM_TOKEN not set in .env file!\n");
+  console.error("Steps to fix:");
+  console.error("1. Go to: https://www.npmjs.com/settings/YOUR_USERNAME/tokens");
+  console.error("2. Create a new token (Automation type)");
+  console.error("3. Copy the token");
+  console.error("4. Edit .env file and replace YOUR_NPM_ACCESS_TOKEN_HERE with your token");
+  console.error("5. Run this script again\n");
+  process.exit(1);
+}
+
+console.log("✅ NPM_TOKEN found in .env");
+
+// Create .npmrc with token
+const npmrcPath = join(homedir(), '.npmrc');
+let existingNpmrc = '';
+
+if (existsSync(npmrcPath)) {
+  existingNpmrc = readFileSync(npmrcPath, 'utf8');
+  console.log("ℹ️  Backing up existing .npmrc");
+  writeFileSync(npmrcPath + '.backup', existingNpmrc);
+}
+
+// Write token to .npmrc
+const npmrcContent = `//registry.npmjs.org/:_authToken=${npmToken}\n`;
+writeFileSync(npmrcPath, npmrcContent);
+console.log("✅ Configured npm authentication\n");
+
+// Run build
+console.log("📦 Building package...");
+const buildProc = spawn('npm', ['run', 'build'], {
+  stdio: 'inherit',
+  shell: true
+});
+
+buildProc.on('close', (code) => {
+  if (code !== 0) {
+    console.error("\n❌ Build failed!");
+    cleanup();
+    process.exit(1);
+  }
+
+  console.log("✅ Build successful\n");
+
+  // Run publish
+  console.log("📤 Publishing to npm...");
+  const publishProc = spawn('npm', ['publish', '--access', 'public'], {
+    stdio: 'inherit',
+    shell: true
+  });
+
+  publishProc.on('close', (publishCode) => {
+    cleanup();
+
+    if (publishCode !== 0) {
+      console.error("\n❌ Publish failed!");
+      console.error("\nCommon issues:");
+      console.error("- Version already published (bump version in package.json)");
+      console.error("- Invalid token (check your .env file)");
+      console.error("- Network issues");
+      process.exit(1);
+    }
+
+    console.log("\n" + "=".repeat(60));
+    console.log("  ✅ SUCCESS! Package published to npm!");
+    console.log("=".repeat(60));
+    console.log("\n📦 Package: @nihalcastelino/project-brain-mcp");
+    console.log("🔗 URL: https://www.npmjs.com/package/@nihalcastelino/project-brain-mcp");
+    console.log("\n📥 Install with:");
+    console.log("   npm install -g @nihalcastelino/project-brain-mcp");
+    console.log("\n🎉 Next steps:");
+    console.log("   1. Test installation");
+    console.log("   2. Make GitHub repo public");
+    console.log("   3. Announce beta!\n");
+  });
+});
+
+// Cleanup function
+function cleanup() {
+  console.log("\n🧹 Cleaning up...");
+
+  // Restore original .npmrc if it existed
+  const backupPath = join(homedir(), '.npmrc.backup');
+  if (existsSync(backupPath)) {
+    const backup = readFileSync(backupPath, 'utf8');
+    writeFileSync(npmrcPath, backup);
+    console.log("✅ Restored original .npmrc");
+  }
+  // Note: If no backup existed, we leave the .npmrc as-is for now
+  // User can manually remove it if needed
+}
+
+// Handle interrupts
+process.on('SIGINT', () => {
+  console.log("\n\n⚠️  Interrupted by user");
+  cleanup();
+  process.exit(1);
+});

package/publish.bat

@@ -0,0 +1,72 @@
+@echo off
+REM Project Brain MCP - Publish to npm Script
+echo ================================================
+echo   Publishing Project Brain MCP to npm
+echo ================================================
+echo.
+
+echo Step 1: Building package...
+call npm run build
+if errorlevel 1 (
+    echo ERROR: Build failed!
+    pause
+    exit /b 1
+)
+echo ✅ Build successful
+echo.
+
+echo Step 2: Logging into npm...
+echo.
+echo INSTRUCTIONS:
+echo - You'll be prompted for username/password OR
+echo - If you have an access token, use:
+echo   Username: your-npm-username
+echo   Password: paste your access token here
+echo.
+call npm login
+if errorlevel 1 (
+    echo ERROR: npm login failed!
+    pause
+    exit /b 1
+)
+echo ✅ Logged in successfully
+echo.
+
+echo Step 3: Verifying package...
+echo Package name: @nihalcastelino/project-brain-mcp
+echo Version: 1.0.0
+echo.
+echo Press any key to continue with publish, or Ctrl+C to cancel...
+pause > nul
+
+echo Step 4: Publishing to npm...
+call npm publish --access public
+if errorlevel 1 (
+    echo ERROR: Publish failed!
+    echo.
+    echo Common issues:
+    echo - Package version already exists (bump version in package.json)
+    echo - Not authorized for @nihalcastelino org
+    echo - Network issues
+    pause
+    exit /b 1
+)
+
+echo.
+echo ================================================
+echo   ✅ SUCCESS! Package published!
+echo ================================================
+echo.
+echo Your package is now available at:
+echo https://www.npmjs.com/package/@nihalcastelino/project-brain-mcp
+echo.
+echo Users can install it with:
+echo npm install -g @nihalcastelino/project-brain-mcp
+echo.
+echo Next steps:
+echo 1. Verify on npmjs.com
+echo 2. Test installation: npm install -g @nihalcastelino/project-brain-mcp
+echo 3. Make GitHub repo public
+echo 4. Announce beta!
+echo.
+pause

package/scripts/setup.cjs

@@ -0,0 +1,238 @@
+#!/usr/bin/env node
+
+/**
+ * Project Brain Free Tier - Zero-Config Setup
+ * Automatically configures Claude Desktop, Cursor, and other MCP-compatible tools
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// Color codes for terminal
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m',
+  gray: '\x1b[90m',
+};
+
+const log = {
+  success: (msg) => console.log(`${colors.green}✅ ${msg}${colors.reset}`),
+  warning: (msg) => console.log(`${colors.yellow}⚠️  ${msg}${colors.reset}`),
+  info: (msg) => console.log(`${colors.blue}ℹ️  ${msg}${colors.reset}`),
+  dim: (msg) => console.log(`${colors.gray}   ${msg}${colors.reset}`),
+};
+
+// AI Tool configurations
+const AI_TOOLS = {
+  claude: {
+    name: 'Claude Desktop',
+    configPaths: {
+      win32: path.join(os.homedir(), 'AppData', 'Roaming', 'Claude', 'claude_desktop_config.json'),
+      darwin: path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json'),
+      linux: path.join(os.homedir(), '.config', 'claude', 'claude_desktop_config.json'),
+    },
+  },
+  cursor: {
+    name: 'Cursor',
+    configPaths: {
+      win32: path.join(os.homedir(), 'AppData', 'Roaming', 'Cursor', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json'),
+      darwin: path.join(os.homedir(), 'Library', 'Application Support', 'Cursor', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json'),
+      linux: path.join(os.homedir(), '.config', 'Cursor', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json'),
+    },
+  },
+};
+
+class FreeTierSetup {
+  constructor() {
+    this.platform = os.platform();
+    this.isGlobalInstall = !__dirname.includes('node_modules');
+    this.serverPath = this.getServerPath();
+    this.dbPath = path.join(os.homedir(), '.project-brain', 'tasks.db');
+  }
+
+  getServerPath() {
+    // If globally installed via npm
+    if (process.env.npm_config_global === 'true' || this.isGlobalInstall) {
+      const globalNodeModules = require('child_process')
+        .execSync('npm root -g')
+        .toString()
+        .trim();
+      return path.join(globalNodeModules, '@project-brain', 'mcp', 'dist', 'server.js');
+    }
+
+    // If locally installed or running from source
+    return path.join(__dirname, '..', 'dist', 'server.js');
+  }
+
+  async run() {
+    try {
+      console.log(`\n${colors.cyan}${colors.bright}🧠 Project Brain - Free Tier Setup${colors.reset}\n`);
+
+      // Ensure database directory exists
+      this.ensureDbDirectory();
+
+      // Detect and configure AI tools
+      const configured = await this.autoConfigureTools();
+
+      // Print success message
+      this.printSuccess(configured);
+    } catch (error) {
+      log.warning(`Setup encountered an issue: ${error.message}`);
+      log.info('You can manually configure your AI tool to use this MCP server');
+      this.printManualInstructions();
+    }
+  }
+
+  ensureDbDirectory() {
+    const dbDir = path.dirname(this.dbPath);
+    if (!fs.existsSync(dbDir)) {
+      fs.mkdirSync(dbDir, { recursive: true });
+      log.success(`Created database directory: ${dbDir}`);
+    }
+  }
+
+  async autoConfigureTools() {
+    const configured = [];
+
+    log.info('Detecting AI tools...\n');
+
+    for (const [toolKey, tool] of Object.entries(AI_TOOLS)) {
+      const configPath = tool.configPaths[this.platform];
+
+      if (!configPath) {
+        log.dim(`${tool.name}: Not supported on this platform`);
+        continue;
+      }
+
+      const configDir = path.dirname(configPath);
+
+      // Check if tool exists
+      if (!fs.existsSync(configDir) && !fs.existsSync(configPath)) {
+        log.dim(`${tool.name}: Not installed`);
+        continue;
+      }
+
+      try {
+        await this.configureAITool(toolKey, tool, configPath);
+        configured.push(tool.name);
+        log.success(`${tool.name} configured`);
+      } catch (error) {
+        log.warning(`${tool.name}: Could not auto-configure (${error.message})`);
+      }
+    }
+
+    return configured;
+  }
+
+  async configureAITool(toolKey, tool, configPath) {
+    const configDir = path.dirname(configPath);
+
+    // Ensure directory exists
+    if (!fs.existsSync(configDir)) {
+      fs.mkdirSync(configDir, { recursive: true });
+    }
+
+    // Load existing config or create new one
+    let toolConfig = {};
+    if (fs.existsSync(configPath)) {
+      try {
+        const content = fs.readFileSync(configPath, 'utf8');
+        toolConfig = JSON.parse(content);
+      } catch (error) {
+        log.warning(`Could not parse existing ${tool.name} config, creating backup`);
+        fs.copyFileSync(configPath, `${configPath}.backup.${Date.now()}`);
+      }
+    }
+
+    // Add Project Brain MCP server configuration
+    if (!toolConfig.mcpServers) {
+      toolConfig.mcpServers = {};
+    }
+
+    // Check if already configured
+    if (toolConfig.mcpServers['project-brain']) {
+      log.dim(`   ${tool.name} already has project-brain configured, updating...`);
+    }
+
+    toolConfig.mcpServers['project-brain'] = {
+      command: 'node',
+      args: [this.serverPath],
+      env: {
+        PROJECT_BRAIN_DB_PATH: this.dbPath
+      }
+    };
+
+    // Write updated config
+    fs.writeFileSync(configPath, JSON.stringify(toolConfig, null, 2));
+  }
+
+  printSuccess(configured) {
+    console.log(`\n${colors.green}${colors.bright}✨ Project Brain Setup Complete!${colors.reset}\n`);
+
+    if (configured.length > 0) {
+      console.log(`${colors.green}Configured AI tools:${colors.reset}`);
+      configured.forEach(tool => console.log(`   ✅ ${tool}`));
+      console.log();
+      log.info('Next steps:');
+      console.log('   1. Restart your AI tool(s)');
+      console.log('   2. Try: "Create a task to test Project Brain"');
+      console.log('   3. Try: "List all my tasks"\n');
+    } else {
+      log.warning('No AI tools detected for auto-configuration\n');
+      this.printManualInstructions();
+    }
+
+    console.log(`${colors.cyan}Database location:${colors.reset}`);
+    console.log(`   ${this.dbPath}\n`);
+
+    console.log(`${colors.cyan}Features (Free Tier):${colors.reset}`);
+    console.log('   ✅ Up to 100 tasks per project');
+    console.log('   ✅ Full-text search');
+    console.log('   ✅ Import/export');
+    console.log('   ✅ 100% local, works offline\n');
+
+    console.log(`${colors.gray}Need unlimited tasks? Upgrade at: https://projectbrain.ai/pricing${colors.reset}\n`);
+  }
+
+  printManualInstructions() {
+    console.log(`\n${colors.cyan}Manual Configuration:${colors.reset}\n`);
+
+    console.log(`Add this to your AI tool's MCP settings:\n`);
+    console.log(colors.gray + JSON.stringify({
+      mcpServers: {
+        "project-brain": {
+          command: "node",
+          args: [this.serverPath],
+          env: {
+            PROJECT_BRAIN_DB_PATH: this.dbPath
+          }
+        }
+      }
+    }, null, 2) + colors.reset + '\n');
+
+    console.log(`${colors.cyan}Config file locations:${colors.reset}`);
+    Object.values(AI_TOOLS).forEach(tool => {
+      const configPath = tool.configPaths[this.platform];
+      if (configPath) {
+        console.log(`   ${tool.name}: ${configPath}`);
+      }
+    });
+    console.log();
+  }
+}
+
+// Run setup
+if (require.main === module) {
+  const setup = new FreeTierSetup();
+  setup.run().catch(error => {
+    console.error('Setup failed:', error);
+    process.exit(1);
+  });
+}
+
+module.exports = FreeTierSetup;