codebase-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@codebase-mcp what tech stack does this project use?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
codebase-mcp
Servidor MCP (Model Context Protocol) Zero-Config para conectar código local con asistentes de IA.
Zero-config CLI that turns any local repository into a Model Context Protocol (MCP) server for Claude, Cursor, Antigravity IDE, and AI agents.
Español
codebase-mcp proporciona a Claude Code, Claude Desktop, Cursor, Antigravity IDE, Windsurf, VS Code y agentes autónomos de IA una visibilidad profunda e instantánea sobre repositorios de código local, sin necesidad de indexadores pesados, bases de datos vectoriales ni configuraciones complejas.
Características
Configuración Cero (Zero-Config): Ejecuta simplemente
npx 714-mcp-toolen cualquier carpeta o especifica--path /ruta/al/proyecto.Motor Híbrido BM25 Inteligente (
search_hybrid): Ranqueo de relevancia léxica y conceptual en milisegundos con tolerancia a errores tipográficos (fuzzy search).E/S Asíncrona de Alto Rendimiento: Operaciones sobre el sistema de archivos no bloqueantes con detección automática de archivos binarios.
Árbol de Proyecto Inteligente (
get_project_tree): Genera mapas limpios en texto plano ASCII respetando.gitignore, con soporte para subcarpetas (sub_path).Búsqueda Instantánea con Filtros (
search_codebase): Búsqueda rápida estilo grep con números de línea, snippets, regex (use_regex), filtros de extensión (file_extensions) y subcarpeta (path_pattern).Esquema e Índice de Símbolos (
get_file_outline): Extrae la tabla de contenidos (funciones, clases, interfaces, métodos, encabezados) con números de línea para ahorrar memoria y contexto a la IA.Análisis de Dependencias e Impacto (
get_file_dependencies): Analiza qué librerías importa un archivo y qué otros archivos del proyecto se verán afectados si se modifica.Inspección de Cambios Git y Diff (
get_git_changes): Muestra archivos modificados, staged y diffs de código para revisiones y generación de commits.Parchado Quirúrgico Seguro (
apply_file_patch): Aplica ediciones de código con validación de coincidencia previa para garantizar integridad y evitar alucinaciones.Lectura Segura de Archivos (
read_project_file): Lee archivos completos o rangos de líneas con límites de tamaño y protección contra Path Traversal.Seguridad Integrada: Bloquea y protege automáticamente archivos sensibles (
.env,.pem,id_rsa,credentials.json,secrets.json,.npmrc,.pypirc, etc.).Diagnóstico de Stack Tecnológico (
inspect_tech_stack): Identifica proyectos Node.js, Python, Go, Rust, Java, PHP, Ruby y entornos Docker.
Related MCP server: Repo Interrogator
Cómo funciona internamente
No necesitas clonar este repositorio manualmente para usarlo. Tu asistente de IA ejecuta codebase-mcp en segundo plano como un proceso local cuando lo necesita.
[ Usuario ] -- "¿Dónde se gestiona la seguridad y qué pasa si la modifico?"
│
▼
[ Asistente IA ] -- (Detecta herramientas de codebase-mcp)
│
├─► 1. Búsqueda híbrida conceptual: search_hybrid(query: "seguridad de credenciales")
│ └─► Retorna: "src/utils/fileSystem.ts (100% Match) -> isSensitiveFile"
│
├─► 2. Análisis de impacto: get_file_dependencies(relative_path: "src/utils/fileSystem.ts")
│ └─► Retorna: "4 archivos dependen de esta función"
│
├─► 3. Edición segura: apply_file_patch(relative_path: "src/utils/fileSystem.ts", target_content: "...", replacement_content: "...")
│ └─► Retorna: "Patched successfully with integrity check"
│
▼
[ Asistente IA ] -- "Se localizó y modificó la función de forma segura verificando su impacto en el proyecto."Inicio Rápido
No requiere instalación previa. Ejecuta directamente usando npx:
npx 714-mcp-toolO especifica la ruta del proyecto explícitamente:
npx 714-mcp-tool --path /ruta/a/tu/proyectoTutoriales de Integración
1. Antigravity IDE / Antigravity
Agrega el servidor a tu archivo de configuración global ~/.gemini/config/mcp_config.json:
{
"mcpServers": {
"codebase-mcp": {
"command": "npx",
"args": ["-y", "714-mcp-tool"]
}
}
}2. Claude Code (CLI de Anthropic)
claude mcp add codebase-mcp -- npx -y 714-mcp-tool3. Cursor IDE
Abre Cursor Settings -> MCP.
Haz clic en + Add New MCP Server.
Configura: Name:
codebase-mcp, Type:command, Command:npx -y 714-mcp-tool.
4. Claude Desktop
Añade en claude_desktop_config.json:
{
"mcpServers": {
"714-mcp-tool": {
"command": "npx",
"args": ["-y", "714-mcp-tool"]
}
}
}Herramientas MCP Expuestas
Herramienta | Parámetros | Descripción |
|
| Búsqueda híbrida inteligente BM25 + Símbolos con ranqueo de relevancia por porcentaje. |
|
| Devuelve la estructura en árbol ASCII del proyecto o subcarpeta respetando |
|
| Busca patrones de texto o regex con filtros opcionales de extensión y carpeta. |
|
| Extrae índice y símbolos (funciones, clases, interfaces, tipos, encabezados) con líneas. |
|
| Análisis de impacto: qué importa este archivo y qué otros archivos del proyecto dependen de él. |
|
| Inspecciona cambios locales de Git (modificados, staged, untracked) y diff para reviews/commits. |
|
| Aplica una edición de código con validación de coincidencia exacta previa. |
|
| Lee el contenido de un archivo de forma segura con números de línea y protección contra binarios. |
| ninguno | Analiza manifiestos del proyecto ( |
English
codebase-mcp gives Claude Code, Claude Desktop, Cursor, Antigravity IDE, Windsurf, VS Code, and autonomous AI agents instant, deep visibility into your local codebases without indexers, vector databases, or complex setup.
Features
Zero Configuration: Simply run
npx 714-mcp-toolin any project folder or specify--path /path/to/project.Smart BM25 Hybrid Search (
search_hybrid): Fast relevance-ranked lexical and symbol search with fuzzy matching in milliseconds.High-Performance Async I/O: Fully non-blocking asynchronous filesystem operations with automatic binary file detection.
Smart Tree Inspection (
get_project_tree): Generates clean ASCII directory maps respecting.gitignore, supporting subfolders (sub_path).Filtered Instant Search (
search_codebase): Fast grep-style search with line numbers, snippets, optional regex, extension filters, and path filters.Symbol & File Outline (
get_file_outline): Extracts declaration table of contents (functions, classes, interfaces, methods, headers) with line numbers to conserve AI tokens.Dependency & Impact Analysis (
get_file_dependencies): Identifies incoming and outgoing dependencies to prevent breaking changes across project files.Git Changes & Diff Inspection (
get_git_changes): Displays uncommitted changes, status, and code diffs for reviews and commit generation.Surgical Safe Patching (
apply_file_patch): Applies surgical edits to files with pre-validation checksum matching.Safe File Reading (
read_project_file): Read specific files or line ranges safely with path traversal protection and binary guards.Security-First: Automatically redacts and blocks access to sensitive credential files (
.env,.pem,id_rsa,credentials.json,secrets.json,.npmrc,.pypirc, etc.).Multi-Language Tech Stack Diagnostics (
inspect_tech_stack): Automatically identifies Node.js, Python, Go, Rust, Java, PHP, Ruby, and Docker setups.
Exposed MCP Tools
Tool | Parameters | Description |
|
| BM25 + Symbol relevance search with percentage score ranking. |
|
| Returns directory tree for whole project or subfolder respecting |
|
| Searches codebase with optional extension and subfolder filtering. |
|
| Extracts table of contents and declarations with line numbers. |
|
| Reverse dependency and impact analysis across project files. |
|
| Inspects uncommitted Git changes, modified files, and code diff. |
|
| Applies a surgical code patch with exact match verification. |
|
| Safely reads project file contents with line numbers and binary guard. |
| none | Analyzes configuration files to summarize language and framework setup. |
License
Distributed under the MIT License. See LICENSE for more information.
Available Tools
4 toolsget_project_treeA
Returns the directory structure and file tree of the local repository, respecting .gitignore rules.
Inputs: max_depth.
inspect_tech_stackA
Analyzes package files (package.json, Cargo.toml, requirements.txt, Dockerfile, etc.) to report project dependencies, frameworks, and setup.
Inputs: no named parameters.
read_project_fileA
Reads the contents of a specific file within the project safely with line numbers.
Inputs: relative_path (required), end_line, start_line.
search_codebaseA
Searches the codebase for a text pattern or regular expression, returning matching files, line numbers, and snippets.
Inputs: query (required), use_regex, max_results.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct aspect of codebase exploration: tree structure, content search, file reading, and dependency analysis. There is no overlap in purpose or output.
All tool names follow a clear verb_noun pattern with snake_case (get_project_tree, search_codebase, read_project_file, inspect_tech_stack). The verbs are distinct and accurately describe the action.
Four tools is well-scoped for a codebase exploration server. Each tool provides a necessary and non-redundant capability, without being overly sparse or bloated.
The set covers common read-only codebase tasks: structural overview, searching, reading files, and identifying tech stack. A minor gap is the lack of direct directory-level file listing or metadata, but the overall surface is sufficient for typical exploration.
Related MCP Connectors
An MCP server that gives your AI access to the source code and docs of all public github repos
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
Related MCP Servers
- AlicenseBqualityDmaintenanceA local-first MCP server that provides AI agents with safe codebase access through file discovery, hybrid lexical-semantic search, and project introspection. It features durable local memory and semantic indexing while keeping all data and processing entirely on your local machine.7427 npm6MIT
- AlicenseAqualityDmaintenanceA local-first MCP server that enables AI tools to safely inspect and search code repositories, providing indexing, deterministic BM25 search, code outlining, and context bundles without code modification.91MIT
- AlicenseNot gradedqualityDmaintenanceA self-hosted MCP server that indexes your codebase and provides AI assistants with deep context including file tree, full-text search, git history, dependencies, and stack detection, all without sending your code to third parties.5 npm1MIT
- AlicenseNot gradedqualityBmaintenanceA local-first MCP server that lets AI assistants search and retrieve context from indexed projects, Git state, decisions, and tasks without sending data to the cloud.MIT