octocode-mcp 2.3.12 → 2.3.15

package/README.md

@@ -8,11 +8,14 @@
   [![Version](https://img.shields.io/badge/version-2.3.2-blue.svg)](./package.json)
   [![License](https://img.shields.io/badge/license-MIT-green.svg)](./package.json)
   [![MCP](https://img.shields.io/badge/MCP-Compatible-purple.svg)](https://modelcontextprotocol.io/)
-  [![Buy me a coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-☕-orange.svg)](https://buymeacoffee.com/bgauryy)
 </div>
 
+
+
 ## What is Octocode? 🐙
 
+**For more details, visit [octocode.ai](https://octocode.ai)**
+
 **The perfect code assistant that can help understand anything.** Octocode provides AI-powered advanced search with heuristic discovery and smart fallbacks to understand connections between repositories and NPM packages across any privilege level you have.
 
 Instead of manually browsing repositories, ask questions like:
@@ -73,6 +76,61 @@ npm login
 
 **That's it!** Octocode automatically works with your organization's private repositories.
 
+## DXT Extension 📦
+
+This project is available as a **Desktop Extension (DXT)** for easy installation in AI applications like Claude Desktop.
+
+### For Developers
+
+**Building the DXT Package:**
+
+```bash
+# Install dependencies
+yarn install
+
+# Build the DXT package
+yarn dxt:pack
+
+# Validate the manifest
+yarn dxt:validate
+
+# View package information
+yarn dxt:info
+
+# Sign the package (optional)
+yarn dxt:sign
+```
+
+**DXT Scripts:**
+- `yarn dxt:validate` - Validate the manifest.json file
+- `yarn dxt:pack` - Build and package the extension as a .dxt file
+- `yarn dxt:info` - Show information about the packaged extension
+- `yarn dxt:sign` - Sign the package with a self-signed certificate
+- `yarn dxt:verify` - Verify the signature of a signed package
+
+**The DXT package includes:**
+- Compiled MCP server (`dist/index.js`)
+- Extension manifest (`manifest.json`)
+- Package metadata (`package.json`)
+- Logo and assets (`assets/logo.png`)
+- Documentation (`README.md`)
+
+**Building DXT from Source:**
+To build the DXT package locally from this repository:
+```bash
+# Clone the repository
+git clone https://github.com/bgauryy/octocode-mcp.git
+cd octocode-mcp
+
+# Install dependencies and build
+yarn install
+yarn build
+yarn dxt:pack
+```
+
+The generated `octocode-mcp.dxt` file can then be installed in Claude Desktop (just click on it and it will open claude desktop with the extension)
+
+
 ## How It Works 🔄
 
 **Smart Discovery Flow:**
@@ -189,4 +247,4 @@ The goal: **make code exploration as intelligent as having a senior developer gu
 
 MIT License - See [LICENSE](./LICENSE.md) for details.
 
----
+---

package/{build → dist}/index.js

@@ -144,29 +144,6 @@ function escapeShellArg(arg, shellType, isGitHubQuery // Flag to indicate if thi
         const isWindows = platform() === 'win32';
         shellType = isWindows ? 'cmd' : 'unix';
     }
-    // Special handling for GitHub search queries to preserve AND logic
-    if (isGitHubQuery) {
-        // If the argument already contains quotes, preserve them for exact phrases
-        if (arg.includes('"')) {
-            // For Unix-like shells, wrap the entire argument in single quotes
-            if (shellType === 'unix') {
-                return `'${arg.replace(/'/g, "'\"'\"'")}'`;
-            }
-            // For Windows CMD
-            if (shellType === 'cmd') {
-                return `"${arg.replace(/"/g, '""')}"`;
-            }
-            // For PowerShell
-            return `'${arg.replace(/'/g, "''")}'`;
-        }
-        // For space-separated terms (AND search), minimize escaping
-        if (arg.includes(' ') && shellType === 'unix') {
-            // Only escape if contains dangerous shell characters
-            if (!/[;&|<>$`\\]/.test(arg)) {
-                return `"${arg}"`;
-            }
-        }
-    }
     switch (shellType) {
         case 'powershell':
             return escapePowerShellArg(arg);
@@ -174,7 +151,7 @@ function escapeShellArg(arg, shellType, isGitHubQuery // Flag to indicate if thi
             return escapeWindowsCmdArg(arg);
         case 'unix':
         default:
-            return escapeUnixShellArg(arg, isGitHubQuery);
+            return escapeUnixShellArg(arg);
     }
 }
 /**
@@ -205,30 +182,10 @@ function escapeWindowsCmdArg(arg) {
  * Preserves AND search logic by not over-escaping space-separated terms
  */
 function escapeUnixShellArg(arg, isGitHubQuery) {
-    // For GitHub search queries, we need to preserve AND logic and quoted phrases
-    if (isGitHubQuery) {
-        // If the query contains quotes, we need to preserve them for GitHub CLI
-        // but escape the entire argument for the shell
-        if (arg.includes('"')) {
-            // Use single quotes to wrap the entire query while preserving internal quotes
-            // This allows GitHub CLI to see: "quoted phrase" other terms
-            return `'${arg.replace(/'/g, "'\"'\"'")}'`;
-        }
-        // For space-separated terms (AND search), only escape if absolutely necessary
-        // GitHub CLI expects space-separated terms for AND logic
-        if (arg.includes(' ') && !/[;&|<>$`\\]/.test(arg)) {
-            // Only wrap in quotes if it contains shell metacharacters beyond spaces
-            return `"${arg}"`;
-        }
-        // For single terms or terms with special chars, escape normally
-        if (/[;&|<>$`\\]/.test(arg)) {
-            return `'${arg.replace(/'/g, "'\"'\"'")}'`;
-        }
-        // Simple terms don't need escaping
-        return arg;
-    }
     // Standard Unix shell escaping for other arguments
-    if (/[^a-zA-Z0-9\-_./=@:]/.test(arg)) {
+    // Only escape if contains dangerous shell metacharacters
+    // Allow common safe characters: alphanumeric, dash, underscore, dot, slash, equals, at, colon, comma
+    if (/[;&|<>$`\\*?()[\]{}^~]/.test(arg)) {
         return `'${arg.replace(/'/g, "'\"'\"'")}'`;
     }
     return arg;
@@ -245,7 +202,28 @@ async function executeNpmCommand(command, args = [], options = {}) {
     // Get shell configuration
     const shellConfig = getShellConfig(options.windowsShell);
     // Build command with validated prefix and properly escaped arguments
-    const escapedArgs = args.map(arg => escapeShellArg(arg, shellConfig.type));
+    // NPM commands need minimal escaping - most arguments are package names or CLI flags
+    const escapedArgs = args.map(arg => {
+        const isCliFlag = arg.startsWith('--');
+        // CLI flags like --searchlimit=20, --json need minimal escaping
+        if (isCliFlag) {
+            // Only escape CLI flags if they contain dangerous shell characters
+            if (/[;&|<>$`\\]/.test(arg)) {
+                return escapeShellArg(arg, shellConfig.type);
+            }
+            return arg;
+        }
+        // Package names and search terms need minimal escaping
+        // Only escape if contains shell metacharacters that could be dangerous
+        if (/[;&|<>$`\\*?[\]{}]/.test(arg)) {
+            return escapeShellArg(arg, shellConfig.type);
+        }
+        // For arguments with spaces, use minimal quoting
+        if (/\s/.test(arg)) {
+            return `"${arg}"`;
+        }
+        return arg;
+    });
     const fullCommand = `npm ${command} ${escapedArgs.join(' ')}`;
     const executeNpmCommand = () => executeCommand(fullCommand, 'npm', options, shellConfig);
     if (options.cache) {
@@ -269,33 +247,40 @@ async function executeGitHubCommand(command, args = [], options = {}) {
     // Get shell configuration
     const shellConfig = getShellConfig(options.windowsShell);
     // Build command with validated prefix and properly escaped arguments
-    // For GitHub search commands, we need to distinguish between:
-    // 1. Main query (index 1) - needs special escaping for AND logic
-    // 2. CLI flags (--flag=value) - standard escaping
-    // 3. Search qualifiers (key:value) - minimal escaping
+    // For GitHub search commands, we need minimal escaping to avoid interfering with GitHub CLI
     const escapedArgs = args.map((arg, index) => {
         const isMainQueryArgument = command === 'search' && index === 1;
         const isCliFlag = arg.startsWith('--');
-        const isGitHubQualifier = command === 'search' &&
-            index > 1 &&
-            !isCliFlag &&
-            (arg.includes(':') || arg.startsWith('('));
-        // CLI flags like --language=javascript, --repo=owner/repo need standard escaping
+        // CLI flags like --language=javascript, --repo=owner/repo need minimal escaping
         if (isCliFlag) {
-            return escapeShellArg(arg, shellConfig.type, false);
+            // Only escape CLI flags if they contain dangerous shell characters
+            if (/[;&|<>$`\\*?[\]{}]/.test(arg)) {
+                return escapeShellArg(arg, shellConfig.type);
+            }
+            return arg;
         }
-        // GitHub search qualifiers need special handling
-        // Most qualifiers can be passed as-is, but those with shell metacharacters need escaping
-        if (isGitHubQualifier) {
-            // Check if the qualifier contains shell metacharacters that need escaping
-            if (/[<>&|;`$\\]/.test(arg)) {
-                // Escape qualifiers that contain shell metacharacters like size:<1000, size:>500
-                return escapeShellArg(arg, shellConfig.type, false);
+        // For search queries, only escape if absolutely necessary for shell safety
+        if (isMainQueryArgument) {
+            // Only escape if the argument contains shell metacharacters that could be dangerous
+            if (/[;&|<>$`\\*?[\]{}]/.test(arg)) {
+                return escapeShellArg(arg, shellConfig.type);
+            }
+            // For simple queries with spaces or special chars, use minimal quoting
+            if (/\s/.test(arg)) {
+                return `"${arg}"`;
             }
-            // Safe qualifiers like "language:typescript", "user:microsoft" can be passed as-is
             return arg;
         }
-        return escapeShellArg(arg, shellConfig.type, isMainQueryArgument);
+        // For other arguments, use minimal escaping
+        // Only escape if contains shell metacharacters that could be dangerous
+        if (/[;&|<>$`\\*?[\]{}]/.test(arg)) {
+            return escapeShellArg(arg, shellConfig.type);
+        }
+        // For arguments with spaces, use minimal quoting
+        if (/\s/.test(arg)) {
+            return `"${arg}"`;
+        }
+        return arg;
     });
     const fullCommand = `gh ${command} ${escapedArgs.join(' ')}`;
     const executeGhCommand = () => executeCommand(fullCommand, 'github', options, shellConfig);
@@ -1355,8 +1340,8 @@ function buildGitHubCliArgs(params) {
     const args = ['code'];
     // Build search query (either exactQuery OR queryTerms, never both)
     if (params.exactQuery) {
-        // Add exact query with quotes for literal matching
-        args.push(`"${params.exactQuery}"`);
+        // Add exact query - let GitHub CLI handle the quoting
+        args.push(params.exactQuery);
     }
     else if (params.queryTerms && params.queryTerms.length > 0) {
         // Add query terms as separate arguments (for AND logic)
@@ -112312,14 +112297,19 @@ async function suggestCodeSearchFallback(owner, filePath) {
 const GITHUB_SEARCH_REPOSITORIES_TOOL_NAME = 'githubSearchRepositories';
 const DESCRIPTION$6 = `Search GitHub repositories using gh search repos CLI.
 
+THREE SEARCH APPROACHES:
+- exactQuery: Single exact phrase/word search
+- queryTerms: Multiple search terms (broader coverage)  
+- topic: Find repositories by technology/subject
+
 BEST PRACTICES:
-- Use topic for discovering repositories by technology/purpose
-- Use query for searching by repository name
-- Use owner to explore specific organizations
-- Use language to filter by programming language
-- Use quality filters (stars, forks) for refinement
+- Use exactQuery for specific repository names
+- Use queryTerms with minimal words for broader results
+- Use topic for technology/subject discovery
+- Use owner for organization exploration
+- Use filters (language, stars, forks) for refinement
 
-Separate searches for different topics and use minimal filters to get the most relevant results`;
+Multiple focused searches work better than complex single queries.`;
 /**
  * Extract owner/repo information from various query formats
  */
@@ -112354,10 +112344,14 @@ function registerSearchGitHubReposTool(server) {
     server.registerTool(GITHUB_SEARCH_REPOSITORIES_TOOL_NAME, {
         description: DESCRIPTION$6,
         inputSchema: {
-            query: z
+            exactQuery: z
                 .string()
                 .optional()
-                .describe('Search by repository name. Use minimal words for repository names or specific projects. For topic discovery, use topic parameter instead.'),
+                .describe('Single exact phrase/word search'),
+            queryTerms: z
+                .array(z.string())
+                .optional()
+                .describe('Multiple search terms for broader coverage'),
             // CORE FILTERS (GitHub CLI flags)
             owner: z
                 .union([z.string(), z.array(z.string())])
@@ -112379,7 +112373,7 @@ function registerSearchGitHubReposTool(server) {
             topic: z
                 .union([z.string(), z.array(z.string())])
                 .optional()
-                .describe('Discover repositories by topic. Use for exploring unknown domains and finding projects by technology or purpose.'),
+                .describe('Find repositories by technology/subject'),
             forks: z
                 .union([
                 z.number().int().min(0),
@@ -112502,15 +112496,29 @@ function registerSearchGitHubReposTool(server) {
             openWorldHint: true,
         },
     }, async (args) => {
+        // Validate that exactly one search parameter is provided (not both)
+        const hasExactQuery = !!args.exactQuery;
+        const hasQueryTerms = args.queryTerms && args.queryTerms.length > 0;
+        if (hasExactQuery && hasQueryTerms) {
+            return createResult({
+                error: 'Use either exactQuery OR queryTerms, not both. Choose one search approach.',
+            });
+        }
         try {
             // Extract owner/repo from query if present
-            const queryInfo = args.query
-                ? extractOwnerRepoFromQuery(args.query)
-                : {
-                    cleanedQuery: '',
-                    extractedOwner: undefined,
-                    extractedRepo: undefined,
-                };
+            const queryInfo = args.exactQuery
+                ? extractOwnerRepoFromQuery(args.exactQuery)
+                : args.queryTerms
+                    ? {
+                        cleanedQuery: args.queryTerms.join(' '),
+                        extractedOwner: undefined,
+                        extractedRepo: undefined,
+                    }
+                    : {
+                        cleanedQuery: '',
+                        extractedOwner: undefined,
+                        extractedRepo: undefined,
+                    };
             // Merge extracted owner with explicit owner parameter
             let finalOwner = args.owner;
             if (queryInfo.extractedOwner && !finalOwner) {
@@ -112519,11 +112527,13 @@ function registerSearchGitHubReposTool(server) {
             // Update parameters with extracted information
             const enhancedArgs = {
                 ...args,
-                query: queryInfo.cleanedQuery || args.query,
+                exactQuery: args.exactQuery ? queryInfo.cleanedQuery : undefined,
+                queryTerms: args.queryTerms,
                 owner: finalOwner,
             };
             // Enhanced validation logic for primary filters
-            const hasPrimaryFilter = enhancedArgs.query?.trim() ||
+            const hasPrimaryFilter = enhancedArgs.exactQuery?.trim() ||
+                (enhancedArgs.queryTerms && enhancedArgs.queryTerms.length > 0) ||
                 enhancedArgs.owner ||
                 enhancedArgs.language ||
                 enhancedArgs.topic ||
@@ -112531,11 +112541,14 @@ function registerSearchGitHubReposTool(server) {
                 enhancedArgs.forks;
             if (!hasPrimaryFilter) {
                 return createResult({
-                    error: `Repository search requires at least one filter. Try these patterns:
-• Topic exploration: { topic: ["react", "typescript"] }
-• Organization search: { owner: "microsoft", visibility: "public" }
-• Language + quality: { language: "go", "good-first-issues": ">=10" }
-• Simple query: { query: "cli shell" }`,
+                    error: `Repository search requires at least one filter. Try:
+• Topic search: { topic: "react" }
+• Exact search: { exactQuery: "cli shell" }  
+• Multiple terms: { queryTerms: ["react", "hooks"] }
+• Organization: { owner: "microsoft" }
+• Language filter: { language: "go" }
+
+Alternative: Use npm search for package discovery.`,
                 });
             }
             // First attempt: Search with current parameters
@@ -112545,19 +112558,21 @@ function registerSearchGitHubReposTool(server) {
                 // Smart fallbacks based on error type
                 if (errorMsg.includes('rate limit')) {
                     return createResult({
-                        error: `GitHub API rate limit. Smart alternatives:
-• Try npm package search for package discovery
-• Use broader filters (remove stars/forks constraints)
-• Search fewer organizations at once
+                        error: `GitHub API rate limit exceeded. Alternatives:
+• Use npm search for package discovery
+• Remove quality filters (stars/forks)  
+• Search fewer organizations
 • Wait 5-10 minutes and retry`,
                     });
                 }
                 if (errorMsg.includes('authentication')) {
                     return createResult({
-                        error: `Authentication required. Quick fix:
-1. Run: gh auth login
-2. For private repos: use api_status_check to verify access
-3. Public repos should work without auth - check query`,
+                        error: `Authentication required:
+• Run: gh auth login
+• For private repos: use api_status_check tool
+• Public repos work without auth
+
+Alternative: Use npm search for packages.`,
                     });
                 }
                 return result; // Return original error for other cases
@@ -112567,31 +112582,26 @@ function registerSearchGitHubReposTool(server) {
             const hasResults = resultData.total_count > 0;
             // Smart fallback strategies for no results
             if (!hasResults) {
-                const fallbackSuggestions = [];
-                if (enhancedArgs.query) {
-                    fallbackSuggestions.push('• Try broader search terms or remove query filter');
+                const suggestions = [];
+                if (enhancedArgs.exactQuery) {
+                    suggestions.push('• Try broader search terms');
                 }
                 if (enhancedArgs.language) {
-                    fallbackSuggestions.push('• Remove language filter for broader discovery');
+                    suggestions.push('• Remove language filter');
                 }
                 if (enhancedArgs.stars || enhancedArgs.forks) {
-                    fallbackSuggestions.push('• Lower quality thresholds (stars/forks)');
+                    suggestions.push('• Lower quality thresholds');
                 }
                 if (!enhancedArgs.topic) {
-                    fallbackSuggestions.push('• 🎯 Try topic exploration: { topic: ["web", "api"] }');
+                    suggestions.push('• Try topic search: { topic: "react" }');
                 }
                 if (enhancedArgs.owner) {
-                    fallbackSuggestions.push('• Search without owner filter for global discovery');
-                    fallbackSuggestions.push('• Use npm package search if looking for packages');
+                    suggestions.push('• Remove owner filter for global search');
                 }
+                suggestions.push('• Use npm search for package discovery');
                 return createResult({
-                    error: `No repositories found. Try these alternatives:
-${fallbackSuggestions.join('\n')}
-
-Quick discovery patterns:
-• 🎯 Topic exploration: { topic: ["react"] }
-• Organization search: { owner: "microsoft" }
-• Quality filter: { stars: ">100", language: "python" }`,
+                    error: `No repositories found. Try:
+${suggestions.join('\n')}`,
                 });
             }
             // Fallback for private repositories: If no results and owner is specified, try with private visibility
@@ -112721,13 +112731,19 @@ async function searchGitHubRepos(params) {
     });
 }
 function buildGitHubReposSearchCommand(params) {
-    const query = params.query?.trim() || '';
     const args = ['repos'];
-    const hasEmbeddedQualifiers = query &&
-        /\b(stars|language|org|repo|topic|user|created|updated|size|license|archived|fork|good-first-issues|help-wanted-issues):/i.test(query);
-    if (query) {
-        args.push(query);
+    let queryForQualifierCheck = '';
+    if (params.exactQuery) {
+        args.push(params.exactQuery.trim());
+        queryForQualifierCheck = params.exactQuery.trim();
     }
+    else if (params.queryTerms && params.queryTerms.length > 0) {
+        // Add each term as separate argument for AND logic
+        params.queryTerms.forEach(term => args.push(term.trim()));
+        queryForQualifierCheck = params.queryTerms.join(' ');
+    }
+    const hasEmbeddedQualifiers = queryForQualifierCheck &&
+        /\b(stars|language|org|repo|topic|user|created|updated|size|license|archived|fork|good-first-issues|help-wanted-issues):/i.test(queryForQualifierCheck);
     args.push('--json=name,fullName,description,language,stargazersCount,forksCount,updatedAt,createdAt,url,owner,isPrivate,license,hasIssues,openIssuesCount,isArchived,isFork,visibility');
     const addArg = (paramName, cliFlag, condition = true, formatter) => {
         const value = params[paramName];
@@ -113434,23 +113450,19 @@ function buildGitHubPullRequestsListCommand(params) {
 const NPM_PACKAGE_SEARCH_TOOL_NAME = 'npmPackageSearch';
 const DESCRIPTION$3 = `Search NPM packages using 'npm search' command. Discover packages by functionality keywords and explore alternatives.
 
-CAPABILITIES:
-- Package discovery: npm search <term> --json --searchlimit=<n>
-- Multiple search terms: searches each term separately and combines results
-- Functional keyword search: "testing", "validation", "http client" 
-- Repository URL extraction for GitHub integration
-- Deduplication and result optimization
+**WHEN TO USE**: Use when users ask questions about npm packages or need to discover packages - provides package discovery and ecosystem insights.
 
-SEARCH STRATEGY:
+**KEY INSIGHTS**:
+- Another code search mechanism for npm packages (along github repository search)
+- Repo discovery by npm packages search
+- Package descriptions, keywords, and version information
+- Can be used undesrsant npm depndencies better
+
+**SEARCH STRATEGY**:
 - Use broad functional terms for best discovery
 - Single keywords work better than complex phrases
 - Multiple searches reveal ecosystem alternatives
-- Results include package names, versions, descriptions, and repository links
-
-USAGE EXAMPLES:
-- Single search: queries="testing" 
-- Multiple searches: queries=["react", "hooks", "typescript"]
-- Limit results: searchLimit=10`;
+- Combine with npm_view_package for detailed analysis of discovered packages`;
 const MAX_DESCRIPTION_LENGTH = 100;
 const MAX_KEYWORDS = 10;
 function registerNpmSearchTool(server) {
@@ -114317,18 +114329,20 @@ function buildGitHubIssuesAPICommand(params) {
 const NPM_VIEW_PACKAGE_TOOL_NAME = 'npmViewPackage';
 const DESCRIPTION = `View NPM package information using 'npm view' command. Supports field-specific queries and GitHub repository discovery.
 
-CAPABILITIES:
+**WHEN TO USE**: Use when users ask questions about npm packages - provides comprehensive package data and insights.
+
+**KEY INSIGHTS**:
+- Git repository URL for source code exploration
+- Package exports structure (understand API surface and dependencies)
+- Dependencies/devDependencies for ecosystem analysis
+- Version history, size, performance metrics
+- License and author information
+
+**CAPABILITIES**:
 - Full package info: npm view <package> --json (optimized format)
-- Single field: npm view <package> <field> (e.g., version, description, license)
+- Single field: npm view <package> <field> (version, description, license)
 - Multiple fields: filtered JSON response for specific fields
-- Repository URLs for GitHub integration and source code analysis
-- Version history, dependencies, and package metadata
-
-USAGE EXAMPLES:
-- Get version: field="version" 
-- Get repository: field="repository" or match="repository"
-- Get multiple: match=["version", "description", "license"]
-- Get all info: no parameters (returns optimized package data)`;
+- Repository URLs for GitHub integration and source code analysis`;
 function registerNpmViewPackageTool(server) {
     server.registerTool(NPM_VIEW_PACKAGE_TOOL_NAME, {
         description: DESCRIPTION,

package/manifest.json

@@ -0,0 +1,110 @@
+{
+  "dxt_version": "0.1",
+  "name": "octocode-mcp",
+  "display_name": "Octocode MCP Extension",
+  "version": "1.0.0",
+  "description": "GitHub code search and npm package exploration MCP server",
+  "long_description": "A comprehensive MCP server that provides GitHub code search, repository exploration, commit history, pull requests, issues, and npm package search capabilities. This extension enables AI assistants to efficiently search and analyze code across GitHub repositories and npm packages with advanced filtering and content retrieval features.",
+  "author": {
+    "name": "Octocode Team",
+    "email": "support@octocode.dev",
+    "url": "https://github.com/octocode-dev"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/guybary/octocode-mcp"
+  },
+  "homepage": "https://github.com/guybary/octocode-mcp",
+  "documentation": "https://github.com/guybary/octocode-mcp#readme",
+  "support": "https://github.com/guybary/octocode-mcp/issues",
+  "icon": "assets/logo.png",
+  "server": {
+    "type": "node",
+    "entry_point": "dist/index.js",
+    "mcp_config": {
+      "command": "node",
+      "args": ["${__dirname}/dist/index.js"],
+      "env": {
+        "NODE_ENV": "production"
+      }
+    }
+  },
+  "tools": [
+    {
+      "name": "mcp_octocode_apiStatusCheck",
+      "description": "Check GitHub and npm login status"
+    },
+    {
+      "name": "mcp_octocode_githubSearchCode",
+      "description": "Search code across GitHub repositories"
+    },
+    {
+      "name": "mcp_octocode_githubGetFileContent",
+      "description": "Fetch file content from GitHub repositories"
+    },
+    {
+      "name": "mcp_octocode_githubSearchRepositories",
+      "description": "Search GitHub repositories"
+    },
+    {
+      "name": "mcp_octocode_githubSearchCommits",
+      "description": "Search commit history across GitHub repositories"
+    },
+    {
+      "name": "mcp_octocode_githubSearchPullRequests",
+      "description": "Search GitHub pull requests"
+    },
+    {
+      "name": "mcp_octocode_githubSearchIssues",
+      "description": "Search GitHub issues"
+    },
+    {
+      "name": "mcp_octocode_githubViewRepoStructure",
+      "description": "View GitHub repository structure"
+    },
+    {
+      "name": "mcp_octocode_npmPackageSearch",
+      "description": "Search npm packages"
+    },
+    {
+      "name": "mcp_octocode_npmViewPackage",
+      "description": "View npm package information"
+    }
+  ],
+  "keywords": [
+    "github",
+    "npm",
+    "code-search",
+    "repository",
+    "package-manager",
+    "development",
+    "api",
+    "search",
+    "mcp",
+    "octocode"
+  ],
+  "license": "MIT",
+  "compatibility": {
+    "claude_desktop": ">=0.10.0",
+    "platforms": ["darwin", "win32", "linux"],
+    "runtimes": {
+      "node": ">=18.0.0"
+    }
+  },
+  "user_config": {
+    "github_token": {
+      "type": "string",
+      "title": "GitHub Token",
+      "description": "Personal access token for GitHub API (optional, increases rate limits)",
+      "sensitive": true,
+      "required": false
+    },
+    "npm_registry": {
+      "type": "string",
+      "title": "NPM Registry",
+      "description": "NPM registry URL",
+      "default": "https://registry.npmjs.org",
+      "required": false
+    }
+  }
+} 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "octocode-mcp",
-  "version": "2.3.12",
+  "version": "2.3.15",
   "description": "Model Context Protocol (MCP) server for advanced GitHub repository analysis, code discovery, and npm package exploration. Provides AI assistants with powerful tools to search, analyze, and understand codebases across GitHub and npm ecosystems.",
   "author": "Guy Bary <guybary@gmail.com>",
   "homepage": "https://octocode.ai",
@@ -14,10 +14,10 @@
   "engines": {
     "node": ">=18.12.0"
   },
-  "main": "build/index.js",
+  "main": "dist/index.js",
   "license": "MIT",
   "type": "module",
-  "bin": "./build/index.js",
+  "bin": "./dist/index.js",
   "scripts": {
     "build": "yarn lint && rollup -c",
     "build:watch": "rollup -c --watch",
@@ -26,14 +26,23 @@
     "test:watch": "vitest --watch",
     "test:coverage": "vitest run --coverage",
     "test:ui": "vitest --ui",
-    "debug": "npx @modelcontextprotocol/inspector node build/index.js",
+    "debug": "npx @modelcontextprotocol/inspector node dist/index.js",
     "lint": "eslint src/**/*.ts tests/**/*.ts",
     "lint:fix": "eslint src/**/*.ts tests/**/*.ts --fix",
     "format": "prettier --write \"src/**/*.{ts,js,json}\"",
-    "format:check": "prettier --check \"src/**/*.{ts,js,json}\""
+    "format:check": "prettier --check \"src/**/*.{ts,js,json}\"",
+    "dxt:validate": "dxt validate manifest.json",
+    "dxt:pack": "yarn build && dxt pack . octocode-mcp.dxt",
+    "dxt:pack:dev": "yarn build && dxt pack . octocode-mcp-dev.dxt",
+    "dxt:info": "dxt info octocode-mcp.dxt",
+    "dxt:sign": "dxt sign octocode-mcp.dxt --self-signed",
+    "dxt:verify": "dxt verify octocode-mcp.dxt",
+    "release:dxt": "yarn build && dxt pack . octocode-mcp.dxt && dxt sign octocode-mcp.dxt --self-signed"
   },
   "files": [
-    "build"
+    "dist",
+    "manifest.json",
+    "assets"
   ],
   "dependencies": {
     "@babel/core": "^7.28.0",
@@ -47,6 +56,7 @@
     "zod": "^3.25.26"
   },
   "devDependencies": {
+    "@anthropic-ai/dxt": "^0.2.1",
     "@rollup/plugin-commonjs": "^28.0.3",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.1",
@@ -87,6 +97,8 @@
     "semantic-search",
     "typescript",
     "nodejs",
-    "cli-tool"
+    "cli-tool",
+    "dxt",
+    "desktop-extension"
   ]
 }