# octocode-mcp

> MCP server for semantic code research and context generation on real-time using LLM patterns | Search naturally across public & private repos based on your permissions | Transform any accessible codeb

- **URL**: https://www.freshcrate.ai/projects/octocode-mcp
- **Author**: bgauryy
- **Category**: MCP Servers
- **Latest version**: `9.1.1` (2025-12-15)
- **License**: MIT
- **Source**: https://github.com/bgauryy/octocode-mcp
- **Homepage**: https://octocode.ai/
- **Language**: TypeScript
- **GitHub**: 795 stars, 67 forks
- **Registry**: github
- **Tags**: `agent`, `ai`, `ai-agents`, `ai-tools`, `claude-ai`, `code-intelligence`, `code-search`, `context`, `typescript`

## Description

MCP server for semantic code research and context generation on real-time using LLM patterns | Search naturally across public & private repos based on your permissions | Transform any accessible codebase/s into AI-optimized knowledge on simple and complex flows | Find real implementations and live docs from anywhere

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `9.1.1` | 2025-12-15 | Low | ## What's Changed * add releases workflow by @bgauryy in https://github.com/bgauryy/octocode-mcp/pull/237   **Full Changelog**: https://github.com/bgauryy/octocode-mcp/compare/9.1.0...9.1.1 |
| `9.1.0` | 2025-12-15 | Low | # Changelog - PR #236: Build System Modernization  ## [Unreleased]  ### version: "9.1.0"  ### Added - **Standalone Binary Distribution** - Pre-compiled binaries for all major platforms without Node.js dependency   - macOS (Apple Silicon & Intel)   - Linux (x64, ARM64, Alpine/musl)   - Windows (x64) - **One-line Installer Script** - `curl -fsSL https://raw.githubusercontent.com/bgauryy/octocode-mcp/main/install/install.sh \| sh` - **Bun Build Scripts** - Cross-compilation support via ` |
| `8.0.0` | 2025-11-26 | Low | # CHANGELOG - Octocode MCP v8.0.0  > **TL;DR**: Major release introducing local filesystem research capabilities, new license model, and enhanced prompt commands.   ## 🚀 New Features  ### Local Filesystem Research (`octocode-mcp-local` v1.0.1) New MCP server package for local codebase exploration using native Unix tools.  - **`local_ripgrep`** - Fast pattern search with regex, context lines, and pagination - **`local_view_structure`** - Directory tree with file sizes and filtering - |
| `7.0.13` | 2025-11-20 | Low | # PR #211: Prompts Overhaul  **Created:** November 20, 2025    ## 📊 Changes Overview  \| Metric \| Value \| \|--------\|-------\| \| Files Changed \| 16 \| \| Additions \| +3,201 \| \| Deletions \| -96 \| \| Net Change \| +3,105 \|  ---  ## 🎯 What's New  ### ✨ New Features  #### 🔒 Security Review Prompt (`review_security.ts`) - **New AI-guided security review system** - Implements systematic vulnerability assessment workflow - **Key capabilities:**   - Attacker mindset approach for threa |
| `7.0.10` | 2025-11-10 | Low | feat: Add MCP Registry support with automated publishing  - Add server.json for MCP Registry registration - Implement automated publishing workflow - Enhance package distribution with proper file inclusion - Add comprehensive CI/CD documentation - Clean up tool output hints  This release makes Octocode MCP discoverable in the official MCP Registry and establishes a robust automated publishing pipeline. |
| `7.0.0` | 2025-10-15 | Low | # PR #142: Major Architecture Refactoring - Error Handling, Type System, and Code Organization  ## Overview  This PR represents a comprehensive refactoring of the codebase focused on improving maintainability, code organization, and developer experience. The changes consolidate error handling, centralize type definitions, and introduce reusable utility patterns across all GitHub API tools.  **Version**: 6.3.0 → 7.0.0 (Major version bump)  ## Summary Statistics  - **Files Changed**: 30 |
| `6.3.0` | 2025-10-03 | Low | 6.3.0  - Add researchGoal - Improve production monitoring |
| `6.2.0` | 2025-09-28 | Low | ## [6.2.0] - 2025-09-29 - Schema Refactoring & Context Improvements  ###  MAJOR ENHANCEMENT: Schema Architecture Refactoring  #### Added - **Centralized Schema Descriptions**: New `schemDescriptions.ts` module consolidates all tool schema descriptions   - Eliminates code duplication across individual schema files   - Provides consistent, centralized parameter descriptions   - Enables easier maintenance and updates of tool documentation   - Supports structured categorization (scope, filt |
| `6.1.1` | 2025-09-27 | Low | Major Changes      Schema Complexity Reduction     Removed verbose parameter: Eliminated verbose fields from all tool schemas and implementations, reducing schema complexity     Simplified base schemas: Consolidated BaseBulkQueryItemSchema and BaseSingleQuerySchema into unified BaseQuerySchema     Streamlined parameter validation: Replaced complex flexible array schemas with simpler SimpleArraySchema utilities     Parameter Naming Standardization     Code Search: queryTerms → keywords |
| `6.0.0` | 2025-09-24 | Low | ### 🎯 **Overview** This PR implements a comprehensive token reduction and optimization strategy for the Octocode MCP server, focusing on streamlining the codebase and improving response efficiency for AI assistants.  ### 🔧 **Major Changes**  #### **1. Tool Removal & Simplification** - **Removed NPM/Package Search Tools** (`packageSearch`, `npmViewPackage`)   - Eliminated entire NPM ecosystem support (`src/npm/` directory)   - Removed package search schemas and command builders   - Upd |

## Citation

- HTML: https://www.freshcrate.ai/projects/octocode-mcp
- Markdown: https://www.freshcrate.ai/projects/octocode-mcp.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/octocode-mcp/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._