@afterxleep/doc-bot/bin/doc-bot.js

Generic MCP server for intelligent documentation access in any project

#!/usr/bin/env node

import { program } from 'commander';
import path from 'path';
import fs from 'fs-extra';
import { DocsServer } from '../src/index.js';
import { readFileSync } from 'fs';
import { fileURLToPath } from 'url';

const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
const packageJson = JSON.parse(readFileSync(path.join(__dirname, '../package.json'), 'utf8'));

program
  .name('doc-bot')
  .description('Generic MCP server for intelligent documentation access')
  .version(packageJson.version)
  .option('-d, --docs <path>', 'Path to docs folder', 'doc-bot')
  .option('-v, --verbose', 'Enable verbose logging')
  .option('-w, --watch', 'Watch for file changes')
  .parse();

const options = program.opts();

async function main() {
  const docsPath = path.resolve(options.docs);
  
  // Check if documentation folder exists
  if (!await fs.pathExists(docsPath)) {
    console.error(`❌ Documentation folder not found: ${docsPath}`);
    console.log('');
    console.log('📖 To get started, create your documentation folder:');
    console.log('');
    console.log(`  mkdir ${path.basename(docsPath)}`);
    console.log(`  echo "---\nalwaysApply: true\ntitle: Getting Started\n---\n# Getting Started\nThis is your project documentation." > ${path.basename(docsPath)}/getting-started.md`);
    console.log('');
    console.log('📋 Use frontmatter in your markdown files:');
    console.log('   alwaysApply: true   (for global rules)');
    console.log('   alwaysApply: false  (for contextual rules)');
    console.log('');
    console.log('💡 Tip: By default, doc-bot looks for a doc-bot folder.');
    console.log('   Use --docs to specify a different folder.');
    process.exit(1);
  }
  
  const server = new DocsServer({
    docsPath,
    verbose: options.verbose,
    watch: options.watch
  });
  
  if (options.verbose) {
    console.error('🚀 Starting doc-bot...');
    console.error(`📁 Documentation: ${docsPath}`);
    console.error(`⚙️  Configuration: Frontmatter-based`);
    
    if (options.watch) {
      console.error('👀 Watching for file changes...');
    }
  }
  
  await server.start();
  
  if (options.verbose) {
    console.error('✅ Server started successfully!');
  }
}

main().catch(error => {
  console.error('❌ Error:', error.message);
  if (options.verbose) {
    console.error(error.stack);
  }
  process.exit(1);
});