FileScopeMCP

Tu IA ya sabe programar. Ahora conoce tu base de código.

FileScopeMCP observa tu código, clasifica cada archivo por importancia, mapea todas las dependencias y mantiene los resúmenes generados por IA actualizados en segundo plano. Cuando tu LLM pregunta "¿qué hace este archivo?", obtiene una respuesta real sin leer el código fuente.

Funciona con Claude Code, Cursor AI o como un demonio independiente. Compatible con 12 lenguajes de forma nativa.

Características clave

Clasificación por importancia — cada archivo recibe una puntuación de 0 a 10 basada en cuántas cosas dependen de él, qué exporta y dónde se encuentra. Tu LLM ve primero los archivos críticos.

Mapeo de dependencias — seguimiento de importaciones bidireccional en Python, JS/TS, C/C++, Rust, Go, Ruby, Lua, Zig, PHP, C#, Java. También encuentra dependencias circulares.

Siempre actualizado — el observador de archivos + la detección de cambios semánticos significa que los metadatos se actualizan automáticamente. Diferenciación a nivel de AST para TS/JS, análisis potenciado por LLM para todo lo demás. Solo reprocesa lo que realmente cambió.

Intermediario de LLM (Broker) — un proceso en segundo plano coordina todo el trabajo de IA a través de llama-server de llama.cpp (o cualquier API HTTP compatible con OpenAI). La cola de prioridad asegura que las consultas interactivas tengan prioridad sobre el procesamiento en segundo plano. Se ejecuta en una sola GPU.

Panel de control Nexus — una interfaz web en localhost:1234 que te permite explorar visualmente tu base de código en todos tus repositorios. Gráficos de dependencias interactivos, paneles de detalles de archivos, actividad del intermediario en tiempo real y monitoreo de salud por repositorio.

Related MCP server: GonMCPtool

Inicio rápido

git clone https://github.com/admica/FileScopeMCP.git
cd FileScopeMCP
./build.sh          # installs deps, compiles, registers with Claude Code

Eso es todo. Abre una sesión de Claude Code en cualquier proyecto y FileScopeMCP se inicializará automáticamente. Prueba:

find_important_files(limit: 5)
status()

¿Quieres resúmenes de IA? Ejecuta ./setup-llm.sh para obtener una guía específica de la plataforma para configurar llama-server de llama.cpp — consulta docs/llm-setup.md para más detalles. Sin esto, todo lo demás sigue funcionando.

Añade esto al .gitignore de tu proyecto:

.filescope/
.filescope-daemon.log

Herramientas MCP

Panel de control Nexus

npm run nexus       # opens at http://localhost:1234

Un panel web de solo lectura que se conecta a cada repositorio de FileScopeMCP en tu máquina:

• Vista de proyecto — árbol de archivos con colores de calor de importancia e indicadores de obsolescencia, haz clic en cualquier archivo para ver los metadatos completos

• Gráfico de dependencias — visualización interactiva con Cytoscape.js, filtra por directorio, haz clic en los nodos para inspeccionar

• Vista del sistema — estado del intermediario en tiempo real, uso de tokens por repositorio, registro de actividad en streaming

• Configuración — gestiona qué repositorios aparecen, elimina o restaura desde la lista negra

Descubre repositorios automáticamente escaneando directorios .filescope/data.db. No se requiere configuración.

Cómo funciona

Your code changes
    → file watcher picks it up
    → AST diff classifies the change (exports? types? body only?)
    → importance scores recalculated
    → staleness cascades to dependents (only if exports/types changed)
    → LLM broker regenerates summaries, concepts, change impact
    → your AI's next query gets fresh answers

Todo reside en .filescope/data.db (SQLite, modo WAL) por proyecto. El intermediario coordina el trabajo de LLM en todos tus repositorios a través de un socket Unix en ~/.filescope/broker.sock.

Documentación

Licencia

Copyright (c) 2026 admica. Todos los derechos reservados. Consulta LICENSE.