MCP Filesystem Server - Tools for Code Analysis

Servidor MCP con herramientas de análisis de código optimizadas para LLM.

Quick Start

Las herramientas están disponibles automáticamente en cualquier proyecto sin configuración adicional.

Tools

Core Analysis Tools

• graph_analyzer(rootPath) - Analiza complejidad del repositorio (O(N²) evitado)

• call_graph(rootPath, {level, format, maxDepth}) - Genera grafo de llamadas mejorado

• context_builder(rootPath, {text, maxHops, maxTokens, focus}) - Contexto inteligente para LLM

File Operations

• ls_tree(path, maxDepth) - Estructura de directorios como árbol ASCII

• read_context(files) - Leer múltiples archivos (máx 10)

• search_code(path, pattern, useRegex) - Buscar texto/regex en código

• inspect_symbols(file) - Extraer firmas de clases y funciones

• write_unit(path, content) - Escribir archivo atómicamente

Advanced Tools

• diagram_generator(rootPath, {type, format, focus, style}) - Diagramas de arquitectura (C4, sequence)

• pattern_detector(sourceCode, filePath) - Detectar anti-patrones, code smells, seguridad

• run_task(command, timeout) - Ejecutar comandos permitidos

Usage Examples

// Analizar complejidad de un proyecto
graph_analyzer("/src")

// Generar grafo de llamadas
call_graph("/src", {level: "component", format: "mermaid"})

// Contexto inteligente para módulo
context_builder("/src", {
  text: "autenticación de usuarios",
  maxHops: 2,
  maxTokens: 4000
})

// Buscar semánticamente (usar search_code para patrones exactos)
// search_code("/src", "login", false)

Benefits

• Token savings: 70-90% menos tokens vs herramientas nativas

• Analysis depth: Contexto semántico vs análisis superficial

• No setup: Configuración global única

• Fast onboarding: Contexto completo en una llamada

Legacy Tools

• analyze_logic - Usar graph_analyzer en su lugar

• smart_summarize - Usar context_builder en su lugar

• dependency_graph - Usar call_graph en su lugar

• complexity_analyzer - Usar graph_analyzer en su lugar

Configuration

El servidor usa GLM-4.5-Air (Zhipu) con endpoint en https://api.z.ai/v1/chat/completions.

Configuración global en ~/.claude/settings.json ya habilitada.