FileScopeMCP

Ваш ИИ уже умеет писать код. Теперь он знает вашу кодовую базу.

FileScopeMCP следит за вашим кодом, ранжирует каждый файл по важности, составляет карту всех зависимостей и поддерживает актуальность ИИ-описаний в фоновом режиме. Когда ваш LLM спрашивает «что делает этот файл?», он получает реальный ответ, не читая исходный код.

Работает с Claude Code, Cursor AI или как отдельный демон. Поддерживает 12 языков «из коробки».

Основные возможности

Ранжирование важности — каждому файлу присваивается оценка от 0 до 10 на основе того, сколько элементов от него зависят, что он экспортирует и где находится. Ваш LLM видит критически важные файлы в первую очередь.

Карта зависимостей — двунаправленное отслеживание импортов для Python, JS/TS, C/C++, Rust, Go, Ruby, Lua, Zig, PHP, C#, Java. Также находит циклические зависимости.

Всегда актуально — файловый наблюдатель + обнаружение семантических изменений означают, что метаданные обновляются автоматически. Диффинг на уровне AST для TS/JS, анализ на базе LLM для всего остального. Повторно обрабатывается только то, что действительно изменилось.

LLM-брокер — фоновый процесс координирует всю работу ИИ через llama-server из llama.cpp (или любой HTTP API, совместимый с OpenAI). Очередь приоритетов гарантирует, что интерактивные запросы выполняются быстрее фоновой обработки. Работает на одном GPU.

Панель управления Nexus — веб-интерфейс на localhost:1234, который позволяет визуально исследовать вашу кодовую базу во всех репозиториях. Интерактивные графы зависимостей, панели сведений о файлах, активность брокера в реальном времени и мониторинг состояния каждого репозитория.

Related MCP server: GonMCPtool

Быстрый старт

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

Вот и всё. Откройте сессию Claude Code в любом проекте, и FileScopeMCP инициализируется автоматически. Попробуйте:

find_important_files(limit: 5)
status()

Нужны ИИ-описания? Запустите ./setup-llm.sh для получения руководства по настройке llama-server из llama.cpp для вашей платформы — подробности см. в docs/llm-setup.md. Без этого всё остальное будет работать по-прежнему.

Добавьте в .gitignore вашего проекта:

.filescope/
.filescope-daemon.log

Инструменты MCP

Панель управления Nexus

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

Веб-панель управления только для чтения, которая подключается к каждому репозиторию FileScopeMCP на вашем компьютере:

• Вид проекта — дерево файлов с тепловой картой важности и индикаторами устаревания, нажмите на любой файл для получения полных метаданных

• Граф зависимостей — интерактивная визуализация Cytoscape.js, фильтрация по директориям, клик по узлам для проверки

• Вид системы — статус брокера в реальном времени, использование токенов для каждого репозитория, потоковый журнал активности

• Настройки — управление отображаемыми репозиториями, удаление или восстановление из черного списка

Автоматически обнаруживает репозитории путем сканирования директорий .filescope/data.db. Настройка не требуется.

Как это работает

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

Всё хранится в .filescope/data.db (SQLite, режим WAL) для каждого проекта. Брокер координирует работу LLM по всем вашим репозиториям через Unix-сокет по адресу ~/.filescope/broker.sock.

Документация

Лицензия

Copyright (c) 2026 admica. Все права защищены. См. LICENSE.