MCP File Context Server
Servidor de contexto de archivos
Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona contexto del sistema de archivos a los Modelos de Lenguaje Grandes (LLM). Este servidor permite a los LLM leer, buscar y analizar archivos de código con funciones avanzadas de almacenamiento en caché y supervisión de archivos en tiempo real.
Características
Operaciones con archivos
Leer el contenido de archivos y directorios
Lista de archivos con metadatos detallados
Vigilancia de archivos en tiempo real e invalidación de caché
Compatibilidad con múltiples codificaciones de archivos
Recorrido recursivo de directorios
Filtrado de tipos de archivos
Análisis de código
Cálculo de la complejidad ciclomática
Extracción de dependencia
Análisis de comentarios
Métricas de calidad:
Detección de líneas duplicadas
Detección de líneas largas (>100 caracteres)
Identificación de funciones complejas
Recuento de líneas (total, no vacías, comentarios)
Almacenamiento en caché inteligente
Estrategia de almacenamiento en caché LRU (menos utilizado recientemente)
Invalidación automática de caché al realizar cambios en archivos
Almacenamiento en caché con capacidad de tamaño y límites configurables
Estadísticas de caché y métricas de rendimiento
Almacenamiento en caché de los últimos resultados de lectura para búsquedas eficientes
Búsqueda avanzada
Coincidencia de patrones de expresiones regulares
Resultados sensibles al contexto con líneas circundantes configurables
Filtrado de tipos de archivos
Compatibilidad con búsqueda de múltiples patrones
Búsqueda de resultados en caché
Patrones de exclusión
Related MCP server: TokenScope
Instalación
Instalación mediante herrería
Para instalar File Context Server para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install @bsmi021/mcp-file-context-server --client claudeInstalación manual
npm install @modelcontextprotocol/file-context-serverUso
Iniciando el servidor
npx file-context-serverHerramientas disponibles
lista_de_archivos_de_contexto
Enumera los archivos en un directorio con metadatos detallados
{ "path": "./src", "recursive": true, "includeHidden": false }contexto_de_lectura
Lee el contenido de archivos o directorios con metadatos
{ "path": "./src/index.ts", "encoding": "utf8", "maxSize": 1000000, "recursive": true, "fileTypes": ["ts", "js"] }contexto de búsqueda
Busca patrones en archivos con contexto
{ "pattern": "function.*", "path": "./src", "options": { "recursive": true, "contextLines": 2, "fileTypes": ["ts"] } }analizar_código
Analiza archivos de código para métricas de calidad.
{ "path": "./src", "recursive": true, "metrics": ["complexity", "dependencies", "quality"] }estadísticas de caché
Obtiene estadísticas de caché y métricas de rendimiento
{ "detailed": true }
Manejo de errores
El servidor proporciona mensajes de error detallados con códigos de error específicos:
FILE_NOT_FOUND: El archivo o directorio no existePERMISSION_DENIED: Problemas de permisos de accesoINVALID_PATH: Formato de ruta de archivo no válidoFILE_TOO_LARGE: El archivo excede el límite de tamañoENCODING_ERROR: Problemas de codificación de archivosUNKNOWN_ERROR: Errores inesperados
Configuración
Variables de entorno para personalización:
MAX_CACHE_SIZE: Número máximo de entradas almacenadas en caché (predeterminado: 1000)CACHE_TTL: Tiempo de vida de la caché en milisegundos (valor predeterminado: 1 hora)MAX_FILE_SIZE: Tamaño máximo de archivo en bytes para lectura
Desarrollo
# Install dependencies
npm install
# Build
npm run build
# Run tests
npm test
# Start in development mode
npm run devLicencia
Instituto Tecnológico de Massachusetts (MIT)
Contribuyendo
¡Agradecemos sus contribuciones! Lea nuestra Guía de Contribución para obtener más información sobre nuestro código de conducta y el proceso para enviar solicitudes de incorporación de cambios.
Compatibilidad de rutas entre plataformas
Nota: A partir de abril de 2025, todo el manejo de rutas de archivos y directorios en File Context Server se ha actualizado para mejorar la compatibilidad entre plataformas (Windows, macOS, Linux):
Todos los patrones glob utilizan rutas de estilo POSIX (barras diagonales) internamente, lo que garantiza una coincidencia consistente de archivos independientemente del sistema operativo.
Todas las operaciones del sistema de archivos (lectura, escritura, estadísticas, etc.) utilizan rutas absolutas normalizadas para garantizar la confiabilidad.
Si está desarrollando o ampliando el servidor, utilice
path.posix.joinpara patrones glob ypath.normalizepara el acceso al sistema de archivos.Este cambio evita problemas con los separadores de rutas y la coincidencia de archivos en diferentes sistemas operativos.
No se requieren cambios para los usuarios finales, pero los desarrolladores deben seguir estas convenciones al contribuir al proyecto.
Available Tools
6 toolsgenerate_outlineC
Generate a code outline for a file, showing its structure (classes, functions, imports, etc). Supports TypeScript/JavaScript and Python files.
Inputs: path (required).
get_chunk_countA
Get the total number of chunks that will be returned for a read_context request. Use this tool FIRST before reading content to determine how many chunks you need to request. The parameters should match what you'll use in read_context.
Inputs: path (required), encoding, maxSize, recursive, +1 more.
getFilesC
Retrieve multiple files by their paths, returning content and metadata for each file
Inputs: filePathList (required).
get_profile_contextC
Get repository context based on current profile settings
Inputs: refresh.
read_contextA
Read and analyze code files with advanced filtering and chunking. The server automatically ignores common artifact directories and files:
Version Control: .git/
Python: .venv/, pycache/, *.pyc, etc.
JavaScript/Node.js: node_modules/, bower_components/, .next/, dist/, etc.
IDE/Editor: .idea/, .vscode/, .env, etc.
For large files or directories, use get_chunk_count first to determine total chunks, then request specific chunks using chunkNumber parameter.
Inputs: path (required), maxSize, encoding, recursive, +2 more.
set_profileC
Set the active profile for context generation
Inputs: profile_name (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Most tools have distinct purposes, but 'getFiles' and 'read_context' both involve retrieving file content, which could cause confusion. 'generate_outline' and 'get_profile_context' are clearly separate, and 'set_profile' and 'get_chunk_count' are specialized utilities.
Naming is inconsistent with mixed conventions: 'generate_outline' and 'read_context' use snake_case, while 'getFiles' uses camelCase. Verb styles vary (e.g., 'generate' vs. 'get' vs. 'read'), and 'get_chunk_count' includes an underscore while 'getFiles' does not, creating a chaotic pattern.
With 6 tools, the count is well-scoped for a file context server, covering core operations like file retrieval, analysis, and profile management without being overwhelming or too sparse.
The toolset covers key file context operations: retrieving files, analyzing code, generating outlines, and managing profiles. A minor gap exists in update or delete operations for profiles or contexts, but agents can likely work around this for the server's purpose.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
The Cortex MCP server provides read-only access to real-time engineering context from the Cortex developer portal, allowing AI coding assistants to answer natural language questions about your organization's catalog (microservices, libraries, domains, teams, infrastructure), scorecards (engineering standards and best practices), initiatives (goals and deadlines), and Engineering Intelligence metrics. It includes tools for querying documentation, tracking personal entities, and accessing AI-assisted insights across the entire Cortex ecosystem.
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Related MCP Servers
- AlicenseAqualityCmaintenanceA Model Context Protocol (MCP) server that helps large language models index, search, and analyze code repositories with minimal setup22142,325 PyPI1,004MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables token-aware directory exploration and file analysis for LLMs, helping them understand codebases through intelligent scanning and reporting.4MIT

CodeAlive MCPofficial
AlicenseNot gradedqualityBmaintenanceA Model Context Protocol server that enhances AI agents by providing deep semantic understanding of codebases, enabling more intelligent interactions through advanced code search and contextual awareness.90MIT- AlicenseBqualityDmaintenanceA Model Context Protocol (MCP) server that enables AI applications to access and analyze local code repositories without manual uploads, providing file listing, content reading, code searching, and project structure analysis capabilities.7MIT