{"_id":"714-mcp-tool","_rev":"2-66f0db9227e648d7cc7b0fe19d6bbc24","name":"714-mcp-tool","dist-tags":{"latest":"2.0.0"},"versions":{"1.1.0":{"name":"714-mcp-tool","version":"1.1.0","keywords":["mcp","model-context-protocol","claude","cursor","ai","codebase","developer-tools","cli"],"author":{"name":"lembrox"},"license":"MIT","_id":"714-mcp-tool@1.1.0","maintainers":[{"name":"lembrox","email":"misael.mezan7@gmail.com"}],"bin":{"714-mcp-tool":"dist/index.js"},"dist":{"shasum":"09d113ffa9eb4975078153de3fceae5299520ff6","tarball":"https://registry.npmjs.org/714-mcp-tool/-/714-mcp-tool-1.1.0.tgz","fileCount":21,"integrity":"sha512-etDXA0maUlJtiJsaGtL+yyL5EAN0md3b8mp1QBFilrOf/zHM3Ho4jWF+2UkiARYW296RdZ3Ke/kq59/hJNqdLg==","signatures":[{"sig":"MEUCIQCFIyTJiXfX9xuFMVr22WMGLrHyBZ54ZQcQpQ2btP/tSwIgTnixMFuRsBn8B7E82M1mXEu7jxzDkLHpCEusTBEfKsY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":80513},"main":"./dist/index.js","type":"module","gitHead":"b77a908d0aceb411e21c81ed4269e55933cf789c","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc","start":"node ./dist/index.js"},"_npmUser":{"name":"lembrox","email":"misael.mezan7@gmail.com"},"_npmVersion":"10.9.7","description":"Zero-config CLI that turns any local repository into a Model Context Protocol (MCP) server for Claude, Cursor, and AI agents.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"^3.24.2","ignore":"^7.0.3","@modelcontextprotocol/sdk":"^1.6.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.3","vitest":"^3.0.5","typescript":"^5.7.3","@types/node":"^22.13.4"},"_npmOperationalInternal":{"tmp":"tmp/714-mcp-tool_1.1.0_1785522726228_0.32697309069379954","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"714-mcp-tool","version":"2.0.0","description":"Zero-config CLI that turns any local repository into a Model Context Protocol (MCP) server for Claude, Cursor, Antigravity, and AI agents.","type":"module","bin":{"714-mcp-tool":"dist/index.js"},"main":"./dist/index.js","repository":{"type":"git","url":"git+https://github.com/Misa714/codebase-mcp.git"},"bugs":{"url":"https://github.com/Misa714/codebase-mcp/issues"},"homepage":"https://github.com/Misa714/codebase-mcp#readme","scripts":{"build":"tsc && (chmod +x dist/index.js 2>/dev/null || true)","start":"node ./dist/index.js","dev":"tsx src/index.ts","test":"vitest run","prepublishOnly":"npm run test && npm run build"},"keywords":["mcp","model-context-protocol","claude","cursor","antigravity","ai","codebase","developer-tools","cli"],"author":{"name":"lembrox"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.6.0","ignore":"^7.0.3","minisearch":"^7.2.0","zod":"^3.24.2"},"devDependencies":{"@types/node":"^22.13.4","tsx":"^4.19.3","typescript":"^5.7.3","vitest":"^3.0.5"},"_id":"714-mcp-tool@2.0.0","gitHead":"e49c8be0dbee80c655ec94d8647c27ac3aeff280","_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-y10sm8Lk2cajNt186G+2waa2TXMcheAmU3o7JKJN0M1UUCoX2hSplIoU9FIfszmMRjnIItWJuY2pTV1mdxYFAg==","shasum":"a251f68efbbba26e2414cc78a30267e54a748c2e","tarball":"https://registry.npmjs.org/714-mcp-tool/-/714-mcp-tool-2.0.0.tgz","fileCount":15,"unpackedSize":98617,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDgBTg+iTvUINFoGCWWeNnaASkEO2VOlkOE7D5iUxzSuAiB4qRfxxCDrNmPsdTy1K6BvvwQJsC3TKOgnQa2cOIuj8w=="}]},"_npmUser":{"name":"lembrox","email":"misael.mezan7@gmail.com"},"directories":{},"maintainers":[{"name":"lembrox","email":"misael.mezan7@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/714-mcp-tool_2.0.0_1787081081184_0.7374083056378133"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-31T18:32:06.160Z","modified":"2026-08-18T19:24:41.621Z","1.1.0":"2026-07-31T18:32:06.374Z","2.0.0":"2026-08-18T19:24:41.342Z"},"author":{"name":"lembrox"},"license":"MIT","keywords":["mcp","model-context-protocol","claude","cursor","antigravity","ai","codebase","developer-tools","cli"],"description":"Zero-config CLI that turns any local repository into a Model Context Protocol (MCP) server for Claude, Cursor, Antigravity, and AI agents.","maintainers":[{"name":"lembrox","email":"misael.mezan7@gmail.com"}],"readme":"<div align=\"center\">\n\n# codebase-mcp\n\n**Servidor MCP (Model Context Protocol) Zero-Config para conectar código local con asistentes de IA.**  \n*Zero-config CLI that turns any local repository into a Model Context Protocol (MCP) server for Claude, Cursor, Antigravity IDE, and AI agents.*\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![MCP Protocol](https://img.shields.io/badge/MCP-1.0-blue.svg)](https://modelcontextprotocol.io)\n[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18.0.0-green.svg)](https://nodejs.org)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/Misa714/codebase-mcp/pulls)\n\n[Español](#español) | [English](#english)\n\n</div>\n\n---\n\n# Español\n\n`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.\n\n## Características\n\n- **Configuración Cero (Zero-Config)**: Ejecuta simplemente `npx 714-mcp-tool` en cualquier carpeta o especifica `--path /ruta/al/proyecto`.\n- **Motor Híbrido BM25 Inteligente (`search_hybrid`)**: Ranqueo de relevancia léxica y conceptual en milisegundos con tolerancia a errores tipográficos (*fuzzy search*).\n- **E/S Asíncrona de Alto Rendimiento**: Operaciones sobre el sistema de archivos no bloqueantes con detección automática de archivos binarios.\n- **Árbol de Proyecto Inteligente (`get_project_tree`)**: Genera mapas limpios en texto plano ASCII respetando `.gitignore`, con soporte para subcarpetas (`sub_path`).\n- **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`).\n- **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.\n- **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.\n- **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.\n- **Parchado Quirúrgico Seguro (`apply_file_patch`)**: Aplica ediciones de código con validación de coincidencia previa para garantizar integridad y evitar alucinaciones.\n- **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.\n- **Seguridad Integrada**: Bloquea y protege automáticamente archivos sensibles (`.env`, `.pem`, `id_rsa`, `credentials.json`, `secrets.json`, `.npmrc`, `.pypirc`, etc.).\n- **Diagnóstico de Stack Tecnológico (`inspect_tech_stack`)**: Identifica proyectos Node.js, Python, Go, Rust, Java, PHP, Ruby y entornos Docker.\n\n---\n\n## Cómo funciona internamente\n\nNo necesitas clonar este repositorio manualmente para usarlo. Tu asistente de IA ejecuta `codebase-mcp` en segundo plano como un proceso local cuando lo necesita.\n\n```text\n[ Usuario ] -- \"¿Dónde se gestiona la seguridad y qué pasa si la modifico?\"\n    │\n    ▼\n[ Asistente IA ] -- (Detecta herramientas de codebase-mcp)\n    │\n    ├─► 1. Búsqueda híbrida conceptual: search_hybrid(query: \"seguridad de credenciales\")\n    │   └─► Retorna: \"src/utils/fileSystem.ts (100% Match) -> isSensitiveFile\"\n    │\n    ├─► 2. Análisis de impacto: get_file_dependencies(relative_path: \"src/utils/fileSystem.ts\")\n    │   └─► Retorna: \"4 archivos dependen de esta función\"\n    │\n    ├─► 3. Edición segura: apply_file_patch(relative_path: \"src/utils/fileSystem.ts\", target_content: \"...\", replacement_content: \"...\")\n    │   └─► Retorna: \"Patched successfully with integrity check\"\n    │\n    ▼\n[ Asistente IA ] -- \"Se localizó y modificó la función de forma segura verificando su impacto en el proyecto.\"\n```\n\n---\n\n## Inicio Rápido\n\nNo requiere instalación previa. Ejecuta directamente usando `npx`:\n\n```bash\nnpx 714-mcp-tool\n```\n\nO especifica la ruta del proyecto explícitamente:\n\n```bash\nnpx 714-mcp-tool --path /ruta/a/tu/proyecto\n```\n\n---\n\n## Tutoriales de Integración\n\n### 1. Antigravity IDE / Antigravity\n\nAgrega el servidor a tu archivo de configuración global `~/.gemini/config/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"codebase-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"714-mcp-tool\"]\n    }\n  }\n}\n```\n\n### 2. Claude Code (CLI de Anthropic)\n\n```bash\nclaude mcp add codebase-mcp -- npx -y 714-mcp-tool\n```\n\n### 3. Cursor IDE\n\n1. Abre **Cursor Settings** -> **MCP**.\n2. Haz clic en **+ Add New MCP Server**.\n3. Configura: **Name:** `codebase-mcp`, **Type:** `command`, **Command:** `npx -y 714-mcp-tool`.\n\n### 4. Claude Desktop\n\nAñade en `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"714-mcp-tool\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"714-mcp-tool\"]\n    }\n  }\n}\n```\n\n---\n\n## Herramientas MCP Expuestas\n\n| Herramienta | Parámetros | Descripción |\n| :--- | :--- | :--- |\n| **`search_hybrid`** | `query` (requerido), `max_results`, `file_extensions`, `path_pattern` | Búsqueda híbrida inteligente BM25 + Símbolos con ranqueo de relevancia por porcentaje. |\n| **`get_project_tree`** | `max_depth` (defecto: `4`), `sub_path` | Devuelve la estructura en árbol ASCII del proyecto o subcarpeta respetando `.gitignore`. |\n| **`search_codebase`** | `query` (requerido), `max_results`, `use_regex`, `file_extensions`, `path_pattern` | Busca patrones de texto o regex con filtros opcionales de extensión y carpeta. |\n| **`get_file_outline`** | `relative_path` (requerido) | Extrae índice y símbolos (funciones, clases, interfaces, tipos, encabezados) con líneas. |\n| **`get_file_dependencies`** | `relative_path` (requerido) | Análisis de impacto: qué importa este archivo y qué otros archivos del proyecto dependen de él. |\n| **`get_git_changes`** | `include_diff` (defecto: `true`) | Inspecciona cambios locales de Git (modificados, staged, untracked) y diff para reviews/commits. |\n| **`apply_file_patch`** | `relative_path`, `target_content`, `replacement_content`, `allow_multiple` | Aplica una edición de código con validación de coincidencia exacta previa. |\n| **`read_project_file`** | `relative_path` (requerido), `start_line`, `end_line` | Lee el contenido de un archivo de forma segura con números de línea y protección contra binarios. |\n| **`inspect_tech_stack`** | *ninguno* | Analiza manifiestos del proyecto (`package.json`, `Cargo.toml`, etc.) para dar un resumen del stack. |\n\n---\n\n# English\n\n`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.\n\n## Features\n\n- **Zero Configuration**: Simply run `npx 714-mcp-tool` in any project folder or specify `--path /path/to/project`.\n- **Smart BM25 Hybrid Search (`search_hybrid`)**: Fast relevance-ranked lexical and symbol search with fuzzy matching in milliseconds.\n- **High-Performance Async I/O**: Fully non-blocking asynchronous filesystem operations with automatic binary file detection.\n- **Smart Tree Inspection (`get_project_tree`)**: Generates clean ASCII directory maps respecting `.gitignore`, supporting subfolders (`sub_path`).\n- **Filtered Instant Search (`search_codebase`)**: Fast grep-style search with line numbers, snippets, optional regex, extension filters, and path filters.\n- **Symbol & File Outline (`get_file_outline`)**: Extracts declaration table of contents (functions, classes, interfaces, methods, headers) with line numbers to conserve AI tokens.\n- **Dependency & Impact Analysis (`get_file_dependencies`)**: Identifies incoming and outgoing dependencies to prevent breaking changes across project files.\n- **Git Changes & Diff Inspection (`get_git_changes`)**: Displays uncommitted changes, status, and code diffs for reviews and commit generation.\n- **Surgical Safe Patching (`apply_file_patch`)**: Applies surgical edits to files with pre-validation checksum matching.\n- **Safe File Reading (`read_project_file`)**: Read specific files or line ranges safely with path traversal protection and binary guards.\n- **Security-First**: Automatically redacts and blocks access to sensitive credential files (`.env`, `.pem`, `id_rsa`, `credentials.json`, `secrets.json`, `.npmrc`, `.pypirc`, etc.).\n- **Multi-Language Tech Stack Diagnostics (`inspect_tech_stack`)**: Automatically identifies Node.js, Python, Go, Rust, Java, PHP, Ruby, and Docker setups.\n\n---\n\n## Exposed MCP Tools\n\n| Tool | Parameters | Description |\n| :--- | :--- | :--- |\n| **`search_hybrid`** | `query` (required), `max_results`, `file_extensions`, `path_pattern` | BM25 + Symbol relevance search with percentage score ranking. |\n| **`get_project_tree`** | `max_depth` (default: `4`), `sub_path` | Returns directory tree for whole project or subfolder respecting `.gitignore`. |\n| **`search_codebase`** | `query` (required), `max_results`, `use_regex`, `file_extensions`, `path_pattern` | Searches codebase with optional extension and subfolder filtering. |\n| **`get_file_outline`** | `relative_path` (required) | Extracts table of contents and declarations with line numbers. |\n| **`get_file_dependencies`** | `relative_path` (required) | Reverse dependency and impact analysis across project files. |\n| **`get_git_changes`** | `include_diff` (default: `true`) | Inspects uncommitted Git changes, modified files, and code diff. |\n| **`apply_file_patch`** | `relative_path`, `target_content`, `replacement_content`, `allow_multiple` | Applies a surgical code patch with exact match verification. |\n| **`read_project_file`** | `relative_path` (required), `start_line`, `end_line` | Safely reads project file contents with line numbers and binary guard. |\n| **`inspect_tech_stack`** | *none* | Analyzes configuration files to summarize language and framework setup. |\n\n---\n\n## License\n\nDistributed under the **MIT License**. See `LICENSE` for more information.\n","readmeFilename":"README.md","homepage":"https://github.com/Misa714/codebase-mcp#readme","repository":{"type":"git","url":"git+https://github.com/Misa714/codebase-mcp.git"},"bugs":{"url":"https://github.com/Misa714/codebase-mcp/issues"}}