octocode-mcp 2.3.13 → 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

@@ -112297,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
  */
@@ -112339,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())])
@@ -112364,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),
@@ -112487,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) {
@@ -112504,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 ||
@@ -112516,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
@@ -112530,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
@@ -112552,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
@@ -112706,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];

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.13",
+  "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"
   ]
 }