@ngao/search 1.0.0-alpha.5 → 1.0.0-alpha.7

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,
+    },
 };
 
 
@@ -34431,36 +34542,32 @@ 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 claudeConfigFile = path.join(claudeConfigPath, 'claude_desktop_config.json');
+    const claudeDesktopConfig = path.join(claudeConfigPath, 'claude_desktop_config.json');
+    // Claude Code extension uses VS Code settings in the workspace
+    const vscodeSettingsPath = path.join(homeDir, '.vscode', 'settings.json');
     // Check if already set up
-    if (fs.existsSync(claudeConfigFile)) {
-        const existingConfig = JSON.parse(fs.readFileSync(claudeConfigFile, '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 Desktop!');
-            const projectDir = process.env.NGAO_SEARCH_PROJECT || process.cwd();
-            const port = existingConfig.mcpServers['ngao-search'].env?.NGAO_SEARCH_PORT || '3000';
-            rl.close();
-            return { projectDir, port };
+            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 claudeConfig = { mcpServers: {} };
-    if (fs.existsSync(claudeConfigFile)) {
-        claudeConfig = JSON.parse(fs.readFileSync(claudeConfigFile, 'utf8'));
-    }
-    // Add ngao-search server config
-    claudeConfig.mcpServers = claudeConfig.mcpServers || {};
-    claudeConfig.mcpServers['ngao-search'] = {
+    // Server config to add
+    const ngaoServerConfig = {
         command: 'npx',
         args: ['@ngao/search@alpha'],
         env: {
@@ -34469,9 +34576,32 @@ async function setupMCP() {
             MCP_TRANSPORT: 'stdio',
         },
     };
-    // Write to Claude Desktop config
-    fs.writeFileSync(claudeConfigFile, JSON.stringify(claudeConfig, null, 2));
-    console.log(`\n✅ Claude Desktop config updated: ${claudeConfigFile}\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 for Claude Code (VS Code extension) - adds to workspace settings
+    const vscodeSettingsDir = path.dirname(vscodeSettingsPath);
+    if (!fs.existsSync(vscodeSettingsDir)) {
+        fs.mkdirSync(vscodeSettingsDir, { recursive: true });
+    }
+    let vscodeSettings = {};
+    if (fs.existsSync(vscodeSettingsPath)) {
+        vscodeSettings = JSON.parse(fs.readFileSync(vscodeSettingsPath, 'utf8'));
+    }
+    vscodeSettings['claude.mcp'] = vscodeSettings['claude.mcp'] || {};
+    vscodeSettings['claude.mcp'].servers = vscodeSettings['claude.mcp'].servers || {};
+    vscodeSettings['claude.mcp'].servers['ngao-search'] = ngaoServerConfig;
+    fs.writeFileSync(vscodeSettingsPath, JSON.stringify(vscodeSettings, null, 2));
+    console.log(`✅ Claude Code (VSCode) config updated: ${vscodeSettingsPath}`);
     // Create .ngao-search config in project
     const projectConfigPath = path.join(resolvedProjectDir, '.ngao-search.json');
     if (!fs.existsSync(projectConfigPath)) {
@@ -34485,14 +34615,17 @@ async function setupMCP() {
         console.log(`✅ Project config created: ${projectConfigPath}\n`);
     }
     // Show setup instructions
-    console.log('📝 Setup Complete!\n');
-    console.log('✨ NGAO Search is now integrated with Claude Desktop');
-    console.log('Starting server on port ' + port + '...\n');
-    console.log('ℹ️  Configuration Details:');
+    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 config: ' + claudeConfigFile);
+    console.log('📌 Claude Desktop config: ' + claudeDesktopConfig);
+    console.log('📌 Claude Code config: ' + vscodeSettingsPath);
     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 };
 }
@@ -43872,6 +44005,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
  */
@@ -44014,6 +44148,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.5",
+  "version": "1.0.0-alpha.7",
   "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",