@ngao/search 1.0.0-alpha.4 → 1.0.0-alpha.6

package/dist-bundled/main.js

@@ -20114,7 +20114,7 @@ function _stringFormat(Class, format, fnOrRegex, _params = {}) {
  * Used by the MCP SDK server to validate tool inputs
  */
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.toolMetadata = exports.toolSchemas = exports.ListIndexedDirsInputSchema = exports.GetReindexStatusInputSchema = exports.StartReindexInputSchema = exports.GetSearchHistoryInputSchema = exports.GetFileStatisticsInputSchema = exports.GetIndexInfoInputSchema = exports.GetStatsInputSchema = exports.IndexInputSchema = exports.SearchInputSchema = void 0;
+exports.toolMetadata = exports.toolSchemas = exports.NGAO_DOCUMENTATION = exports.GetDocumentationInputSchema = exports.ListIndexedDirsInputSchema = exports.GetReindexStatusInputSchema = exports.StartReindexInputSchema = exports.GetSearchHistoryInputSchema = exports.GetFileStatisticsInputSchema = exports.GetIndexInfoInputSchema = exports.GetStatsInputSchema = exports.IndexInputSchema = exports.SearchInputSchema = void 0;
 const zod_1 = __webpack_require__(7552);
 /**
  * Search tool input schema
@@ -20179,6 +20179,112 @@ exports.GetReindexStatusInputSchema = zod_1.z.object({
  * List indexed dirs tool input schema (no parameters)
  */
 exports.ListIndexedDirsInputSchema = zod_1.z.object({});
+/**
+ * Get documentation tool input schema (no parameters)
+ */
+exports.GetDocumentationInputSchema = zod_1.z.object({});
+/**
+ * NGAO Search Documentation
+ */
+exports.NGAO_DOCUMENTATION = `
+# NGAO Search - MCP Server Documentation
+
+## Overview
+NGAO Search is a Model Context Protocol (MCP) server that provides Claude with the ability to search and understand your codebase.
+
+## Available Tools
+
+### 1. search
+Search through indexed code and documentation.
+- **query** (required): Search query (e.g., "authentication handler", "database connection")
+- **maxResults** (optional): Maximum results (default: 50)
+- **sessionId** (optional): Session ID for tracking search history
+
+Example: Search for "user authentication" in your codebase
+
+### 2. index
+Index a directory for searching.
+- **dirPath** (required): Directory path to index
+
+Example: Index your project directory to make it searchable
+
+### 3. get_stats
+Get indexing statistics about the current index.
+
+### 4. get_index_info
+Get detailed information about the index including file breakdown by language and type.
+
+### 5. get_file_statistics
+Get per-file statistics.
+- **filePath** (optional): Specific file path for detailed stats
+
+### 6. list_indexed_dirs
+List all directories that are currently indexed.
+
+### 7. get_search_history
+Get search history for a session.
+- **sessionId** (required): Session ID to retrieve history for
+
+### 8. start_reindex
+Start a reindex operation to update the index.
+- **dirPath** (required): Directory to reindex
+- **mode** (optional): 'full', 'incremental', or 'smart' (default: incremental)
+
+### 9. get_reindex_status
+Check the status of a reindex operation.
+- **reindexId** (required): Reindex operation ID
+
+### 10. get_documentation
+Get this documentation about NGAO Search capabilities.
+
+## Supported Languages
+- TypeScript/JavaScript
+- Python
+- JSON
+- YAML
+- Markdown
+
+## How to Use
+
+1. **Setup**: Run \`npx @ngao/search@alpha --setup\` to configure Claude Desktop integration
+
+2. **Ask Claude**: Once setup, you can ask Claude questions about your code:
+   - "How does authentication work in this project?"
+   - "Find all database queries"
+   - "Show me the error handling pattern"
+   - "What's the structure of the config system?"
+
+3. **Claude uses NGAO Search**: Behind the scenes, Claude uses the search tools to:
+   - Search your codebase for relevant files
+   - Extract code blocks and documentation
+   - Understand the project structure
+   - Provide accurate, context-aware answers
+
+## Configuration
+
+Project configuration is stored in \`.ngao-search.json\`:
+\`\`\`json
+{
+  "port": 3000,
+  "indexDir": ".ngao-search-index",
+  "includePaths": ["**/*.ts", "**/*.js", "**/*.py", "**/*.md"],
+  "excludePaths": ["node_modules/**", "dist/**", ".git/**"]
+}
+\`\`\`
+
+## Tips for Best Results
+
+1. **Index the right directories**: Make sure your project root is indexed
+2. **Use specific queries**: "Find authentication handlers" works better than "auth"
+3. **Provide context**: Tell Claude what you're working on
+4. **Ask follow-ups**: Claude remembers the search context
+
+## Troubleshooting
+
+- **No results**: Try simpler search terms
+- **Slow searches**: Large projects may take longer initially
+- **Need to reindex**: Run \`start_reindex\` with your project directory
+`;
 /**
  * All tool schemas as an object map
  */
@@ -20192,6 +20298,7 @@ exports.toolSchemas = {
     start_reindex: exports.StartReindexInputSchema,
     get_reindex_status: exports.GetReindexStatusInputSchema,
     list_indexed_dirs: exports.ListIndexedDirsInputSchema,
+    get_documentation: exports.GetDocumentationInputSchema,
 };
 /**
  * Tool metadata mapping tool names to descriptions
@@ -20234,6 +20341,10 @@ exports.toolMetadata = {
         description: 'List all indexed directories',
         schema: exports.ListIndexedDirsInputSchema,
     },
+    get_documentation: {
+        description: 'Get NGAO Search documentation and capabilities',
+        schema: exports.GetDocumentationInputSchema,
+    },
 };
 
 
@@ -33365,18 +33476,27 @@ const logger_1 = __webpack_require__(1789);
 // Check for --setup flag for interactive setup
 const args = process.argv.slice(2);
 const setupMode = args.includes('--setup') || process.env.NGAO_SETUP === 'true';
+// When setup completes, auto-start in MCP stdio mode for Claude
+if (setupMode) {
+    process.env.MCP_TRANSPORT = 'stdio';
+}
 const transport = (process.env.MCP_TRANSPORT || 'http').toLowerCase();
 const httpPort = process.env.PORT ? parseInt(process.env.PORT, 10) : 0; // 0 = random available port
 /**
  * Main async function
  */
 async function main() {
-    // Run setup first if requested
+    // Run setup first if requested, then continue to start server
     if (setupMode) {
         try {
             const { setupMCP } = await Promise.resolve().then(() => __importStar(__webpack_require__(5021)));
-            await setupMCP();
-            process.exit(0);
+            const { projectDir, port } = await setupMCP();
+            // Set environment vars for server startup
+            process.env.NGAO_SEARCH_PROJECT = projectDir;
+            if (port)
+                process.env.NGAO_SEARCH_PORT = port;
+            console.log('\n🚀 Starting NGAO Search MCP server...\n');
+            // Continue to server startup below
         }
         catch (error) {
             console.error('Setup failed:', error);
@@ -34422,44 +34542,70 @@ async function setupMCP() {
     console.log('\n🔧 NGAO Search - MCP Setup for Claude\n');
     const homeDir = process.env.HOME || process.env.USERPROFILE || '.';
     const claudeConfigPath = path.join(homeDir, '.claude');
-    const mcpConfigFile = path.join(claudeConfigPath, 'mcp.json');
+    const claudeDesktopConfig = path.join(claudeConfigPath, 'claude_desktop_config.json');
+    const claudeCodeConfig = path.join(homeDir, '.claude-code', 'config.json');
     // Check if already set up
-    if (fs.existsSync(mcpConfigFile)) {
-        const existingConfig = JSON.parse(fs.readFileSync(mcpConfigFile, 'utf8'));
+    let isAlreadySetup = false;
+    if (fs.existsSync(claudeDesktopConfig)) {
+        const existingConfig = JSON.parse(fs.readFileSync(claudeDesktopConfig, 'utf8'));
         if (existingConfig.mcpServers?.['ngao-search']) {
-            console.log('✅ NGAO Search is already configured in Claude MCP!');
-            rl.close();
-            return;
+            isAlreadySetup = true;
         }
     }
+    if (!isAlreadySetup && fs.existsSync(claudeCodeConfig)) {
+        const existingConfig = JSON.parse(fs.readFileSync(claudeCodeConfig, 'utf8'));
+        if (existingConfig.mcpServers?.['ngao-search']) {
+            isAlreadySetup = true;
+        }
+    }
+    if (isAlreadySetup) {
+        console.log('✅ NGAO Search is already configured in Claude!');
+        const projectDir = process.env.NGAO_SEARCH_PROJECT || process.cwd();
+        const port = '3000';
+        rl.close();
+        return { projectDir, port };
+    }
     // Ask for project directory
     const projectDir = await question('📁 Enter your project directory path (or press Enter for current): ');
     const resolvedProjectDir = projectDir.trim() || process.cwd();
     // Ask for port
     const portAnswer = await question('🔌 Enter port for MCP server (default: 3000): ');
     const port = portAnswer.trim() || '3000';
-    // Create .claude directory if needed
-    if (!fs.existsSync(claudeConfigPath)) {
-        fs.mkdirSync(claudeConfigPath, { recursive: true });
-    }
-    // Read existing config or create new
-    let mcpConfig = { mcpServers: {} };
-    if (fs.existsSync(mcpConfigFile)) {
-        mcpConfig = JSON.parse(fs.readFileSync(mcpConfigFile, 'utf8'));
-    }
-    // Add ngao-search server config
-    mcpConfig.mcpServers = mcpConfig.mcpServers || {};
-    mcpConfig.mcpServers['ngao-search'] = {
+    // Server config to add
+    const ngaoServerConfig = {
         command: 'npx',
         args: ['@ngao/search@alpha'],
         env: {
             NGAO_SEARCH_PORT: port,
             NGAO_SEARCH_PROJECT: resolvedProjectDir,
+            MCP_TRANSPORT: 'stdio',
         },
     };
-    // Write config file
-    fs.writeFileSync(mcpConfigFile, JSON.stringify(mcpConfig, null, 2));
-    console.log(`\n✅ MCP configuration saved to: ${mcpConfigFile}\n`);
+    // Setup Claude Desktop
+    if (!fs.existsSync(claudeConfigPath)) {
+        fs.mkdirSync(claudeConfigPath, { recursive: true });
+    }
+    let claudeDesktopData = { mcpServers: {} };
+    if (fs.existsSync(claudeDesktopConfig)) {
+        claudeDesktopData = JSON.parse(fs.readFileSync(claudeDesktopConfig, 'utf8'));
+    }
+    claudeDesktopData.mcpServers = claudeDesktopData.mcpServers || {};
+    claudeDesktopData.mcpServers['ngao-search'] = ngaoServerConfig;
+    fs.writeFileSync(claudeDesktopConfig, JSON.stringify(claudeDesktopData, null, 2));
+    console.log(`\n✅ Claude Desktop config updated: ${claudeDesktopConfig}`);
+    // Setup Claude Code (VSCode extension)
+    const claudeCodePath = path.dirname(claudeCodeConfig);
+    if (!fs.existsSync(claudeCodePath)) {
+        fs.mkdirSync(claudeCodePath, { recursive: true });
+    }
+    let claudeCodeData = { mcpServers: {} };
+    if (fs.existsSync(claudeCodeConfig)) {
+        claudeCodeData = JSON.parse(fs.readFileSync(claudeCodeConfig, 'utf8'));
+    }
+    claudeCodeData.mcpServers = claudeCodeData.mcpServers || {};
+    claudeCodeData.mcpServers['ngao-search'] = ngaoServerConfig;
+    fs.writeFileSync(claudeCodeConfig, JSON.stringify(claudeCodeData, null, 2));
+    console.log(`✅ Claude Code config updated: ${claudeCodeConfig}`);
     // Create .ngao-search config in project
     const projectConfigPath = path.join(resolvedProjectDir, '.ngao-search.json');
     if (!fs.existsSync(projectConfigPath)) {
@@ -34467,26 +34613,27 @@ async function setupMCP() {
             port,
             indexDir: path.join(resolvedProjectDir, '.ngao-search-index'),
             includePaths: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx', '**/*.py', '**/*.md'],
-            excludePaths: ['node_modules/**', 'dist/**', '.git/**'],
+            excludePaths: ['node_modules/**', 'dist/**', '.git/**', '.ngao-search-index/**'],
         };
         fs.writeFileSync(projectConfigPath, JSON.stringify(projectConfig, null, 2));
         console.log(`✅ Project config created: ${projectConfigPath}\n`);
     }
     // Show setup instructions
-    console.log('📝 Setup Instructions:\n');
-    console.log('1. Claude now has access to NGAO Search MCP server');
-    console.log('2. When you ask Claude about your code, it can:');
-    console.log('   - Search through your project files');
-    console.log('   - Index and understand your codebase');
-    console.log('   - Provide context-aware code suggestions\n');
-    console.log('3. Restart Claude Desktop for changes to take effect\n');
-    console.log(`📍 Project directory: ${resolvedProjectDir}`);
-    console.log(`🔌 Server port: ${port}\n`);
+    console.log('\n📝 Setup Complete!\n');
+    console.log('✨ NGAO Search is now integrated with:');
+    console.log('   • Claude Desktop');
+    console.log('   • Claude Code (VSCode extension)');
+    console.log('\nℹ️  Configuration Details:');
+    console.log('📍 Project directory: ' + resolvedProjectDir);
+    console.log('🔌 Server port: ' + port);
+    console.log('📌 Claude Desktop config: ' + claudeDesktopConfig);
+    console.log('📌 Claude Code config: ' + claudeCodeConfig);
+    console.log('📌 Project config: ' + projectConfigPath + '\n');
+    console.log('🚀 Next: Restart Claude Desktop and Claude Code to start using NGAO Search!\n');
     rl.close();
+    return { projectDir: resolvedProjectDir, port };
 }
 exports.setupMCP = setupMCP;
-// Run setup
-setupMCP().catch(console.error);
 
 
 /***/ },
@@ -43862,6 +44009,7 @@ const mcp_js_1 = __webpack_require__(7011);
 const stdio_js_1 = __webpack_require__(6166);
 const zod_1 = __webpack_require__(7552);
 const tool_registry_1 = __webpack_require__(8223);
+const tool_schemas_1 = __webpack_require__(2439);
 /**
  * MCP Transport - Handles MCP protocol over stdio
  */
@@ -44004,6 +44152,16 @@ class McpTransport {
                 ],
             };
         });
+        this.server.tool('get_documentation', 'Get NGAO Search documentation and capabilities', {}, async () => {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: tool_schemas_1.NGAO_DOCUMENTATION,
+                    },
+                ],
+            };
+        });
     }
     /**
      * Route tool calls to service methods

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngao/search",
-  "version": "1.0.0-alpha.4",
+  "version": "1.0.0-alpha.6",
   "description": "NGAO Search - Model Context Protocol Server for Local Code/Document Search with LLM-Friendly Output",
   "main": "dist/main.js",
   "types": "dist/index.d.ts",