Files MCP сервер

Позволяет агентам быстро находить и редактировать код в кодовой базе с хирургической точностью. Находите символы, редактируйте их везде с революционными возможностями редактирования кода.

Установка

NPX (Рекомендуется)

npx -y mcp-files

Docker

docker run --rm -i flesler/mcp-files

HTTP transport

TRANSPORT=http PORT=3000 npx mcp-files

Конфигурация

Конфигурация NPX

{
  "mcpServers": {
    "mcp-files": {
      "command": "npx",
      "args": ["-y", "mcp-files"]
    }
  }
}

Конфигурация Docker

{
  "mcpServers": {
    "mcp-files": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "flesler/mcp-files"
      ]
    }
  }
}

Конфигурация HTTP

{
  "mcpServers": {
    "mcp-files": {
      "type": "streamableHttp",
      "url": "http://localhost:3000/mcp"
    }
  }
}

Доступные инструменты

Инструмент	Описание
`read_symbol`	Находит и извлекает блоки кода по имени символа из файлов. Поддерживает множественные символы через массив
`import_symbol`	Импортирует и инспектирует JavaScript/TypeScript модули и их свойства
`search_replace`	Поиск и замена с умной обработкой пробелов и дружественными к автоматизации множественными совпадениями...
`insert_text`	Вставляет/заменяет текст в точных диапазонах строк. Идеально для прямых операций со строками из цитирования кода...
`os_notification`	Отправляет уведомления OS используя нативные системы уведомлений

Возможности

Хирургическое редактирование кода с точным обнаружением символов и модификацией диапазонов строк
Кросс-кодовая база интеллекта - мгновенно находите любой символ в целых репозиториях
Рефакторинг без ошибок с обновлением сигнатур функций везде, где они существуют
Оптимизация кода для AI обработки с удалением комментариев и нормализацией отступов
Поиск множественных символов с поддержкой паттернов подстановки
Умная обработка пробелов в операциях поиска и замены
Кроссплатформенная поддержка (Linux, macOS, Windows, WSL)
Типобезопасные инструменты с валидацией Zod
Оптимизированная производительность с мемоизацией

Переменные окружения

Опциональные

TRANSPORT - Режим транспорта: stdio или http
PORT - Порт HTTP сервера (когда TRANSPORT=http)
DEBUG - Включить режим отладки и инструмент utils_debug

Примеры использования

Найти и улучшить любую функцию в кодовой базе

Добавить документацию к любому символу

Исправить баги в любом месте кодовой базы с хирургической точностью

Обновить сигнатуры функций везде, где они существуют

Модифицировать API во всех файлах одновременно

Ресурсы

GitHub Repository

Примечания

Требует Node.js ≥20. Комбинация read_symbol + insert_text открывает революционные возможности редактирования кода, которые трансформируют то, как AI агенты работают с кодовыми базами. Если вы столкнулись с ERR_MODULE_NOT_FOUND при запуске npx mcp-files, очистите кэш npx командой 'npx clear-npx-cache' и попробуйте снова.