Proveedor de contexto de código MCP

Servidor MCP que proporciona contexto y análisis de código para asistentes de IA. Extrae la estructura de directorios y los símbolos de código mediante analizadores WebAssembly Tree-sitter sin dependencias nativas.

Características

• Generar estructura de árbol de directorios

• Analizar archivos JavaScript/TypeScript y Python

• Extraer símbolos de código (funciones, variables, clases, importaciones, exportaciones)

• Compatible con el protocolo MCP para una integración perfecta con asistentes de IA

Related MCP server: git-project-xray-mcp

Uso rápido (configuración de MCP)

Instalación mediante herrería

Para instalar automáticamente el proveedor de contexto de código para Claude Desktop a través de Smithery :

npx -y @smithery/cli install @AB498/code-context-provider-mcp --client claude

Ventanas

{
  "mcpServers": {
    "code-context-provider-mcp": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "npx",
        "-y",
        "code-context-provider-mcp@latest"
      ]
    }
  }
}

MacOS/Linux

{
  "mcpServers": {
    "code-context-provider-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "code-context-provider-mcp@latest"
      ]
    }
  }
}

O instalar globalmente con npm :

npm install -g code-context-provider-mcp

Luego úsalo ejecutando:

code-context-provider-mcp # if you're not using @latest, you may want to clear the cache for latest version using `Remove-Item -Path "$env:LOCALAPPDATA\npm-cache\_npx" -Recurse -Force` for windows and `rm -rf ~/.npm/_npx` for linux/macos

Herramientas disponibles

get_code_context

Analiza un directorio y devuelve su estructura junto con símbolos de código (opcional).

Parámetros:

• absolutePath (cadena, obligatoria): ruta absoluta al directorio a analizar

• analyzeJs (booleano, opcional): si se deben analizar archivos JavaScript/TypeScript y Python (valor predeterminado: falso)

• includeSymbols (booleano, opcional): si se deben incluir símbolos de código en la respuesta (valor predeterminado: falso)

• symbolType (enum, opcional): Tipo de símbolos a incluir si includeSymbols es verdadero (opciones: 'funciones', 'variables', 'clases', 'importaciones', 'exportaciones', 'todas', predeterminado: 'todas')

• filePatterns (matriz de cadenas, opcional): patrones de archivos para analizar (por ejemplo, [' .js', ' .py', 'config.*'])

• maxDepth (número, opcional): profundidad máxima del directorio a analizar (predeterminado: 5 niveles)

Nota: Las funciones anónimas se filtran automáticamente de los resultados.

Ejemplo de texto de salida al llamar a la herramienta

Directory structure for: C:\Users\Admin\Desktop\mcp\context-provider-mcp

Code Analysis Summary:
- Files analyzed: 3
- Total functions: 29
- Total variables: 162
- Total classes: 0

Note: Symbol analysis is supported for JavaScript/TypeScript (.js, .jsx, .ts, .tsx) and Python (.py) files only.

Code analysis limited to a maximum depth of 5 directory levels (default).

├── index.js (39 KB)
│   └── [Analyzed: 22 functions, 150 variables, 0 classes]
│       Functions:
│       - initializeTreeSitter [39:0]
│       - getLanguageFromExtension [107:0]
│       - getPosition [138:24]

Ejemplos de patrones de archivos

Puede usar el parámetro filePatterns para especificar los archivos que se analizarán. Esto resulta útil para proyectos complejos con varios idiomas o archivos específicos de interés.

Ejemplos:

• ["*.js", "*.py"] - Analiza todos los archivos JavaScript y Python

• ["config.*"] - Analiza todos los archivos de configuración independientemente de la extensión

• ["package.json", "*.config.js"] - Analiza package.json y cualquier archivo de configuración de JavaScript

• [".ts", ".tsx", ".py"] - Analizar archivos TypeScript y Python (usando el formato de extensión)

La coincidencia de patrones de archivos admite:

• Patrones de globos simples con comodines (*)

• Extensiones de archivo directas (con o sin punto)

• Nombres de archivo exactos

Manejo de grandes proyectos

Para proyectos muy grandes, puede utilizar el parámetro maxDepth para limitar la profundidad con la que la herramienta recorrerá los directorios:

• maxDepth: 2 - Solo analiza el directorio raíz y un nivel de subdirectorios

• maxDepth: 3 - Analiza la raíz y dos niveles de subdirectorios

• maxDepth: 0 - Solo analiza archivos en el directorio raíz

Esto es particularmente útil cuando:

• Trabajar con grandes repositorios mono

• Análisis de proyectos con muchas dependencias

• Centrarse únicamente en el código fuente principal y no en las bibliotecas de terceros

Idiomas compatibles

El análisis de símbolos de código es compatible con:

• JavaScript (.js)

• JSX (.jsx)

• TypeScript (.ts)

• TSX (.tsx)

• Python (.py)

El uso del parámetro filePatterns permite incluir otros tipos de archivos en la estructura del directorio, aunque el análisis simbólico puede ser limitado.

Desarrollo

Configuración del entorno de desarrollo

# Clone the repository
git clone https://github.com/your-username/code-context-provider-mcp.git
cd code-context-provider-mcp

# Install dependencies
npm install

# Set up WASM parsers
npm run setup

Post-instalación

Tras la instalación, el script prepare del paquete se ejecuta automáticamente para descargar los analizadores WASM. Si por algún motivo la descarga falla, los usuarios pueden ejecutar la configuración manualmente:

npx code-context-provider-mcp-setup

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Para obtener más información o ayuda

• Correo electrónico (abcd49800@gmail.com)

• Discord (CodePlayground)