-
security-
license-
qualityNode.js server implementing Model Context Protocol for filesystem operations, allowing Claude to read, write, and manipulate files and directories in specified locations.
Файловая система MCP-сервера
Сервер Node.js, реализующий протокол контекста модели (MCP) для операций файловой системы.
Функции
Чтение/запись файлов
Создание/список/удаление каталогов
Переместить файлы/каталоги
Поиск файлов
Получить метаданные файла
Примечание : сервер разрешит операции только в пределах каталогов, указанных с помощью args .
API
Ресурсы
file://system: Интерфейс операций файловой системы
Инструменты
прочитанный_файл
Прочитать полное содержимое файла
Ввод:
path(строка)Считывает полное содержимое файла в кодировке UTF-8
чтение_нескольких_файлов
Чтение нескольких файлов одновременно
Ввод:
paths(string[])Неудачные чтения не остановят всю операцию.
запись_файла
Создайте новый файл или перезапишите существующий (будьте осторожны)
Входные данные:
path(строка): Расположение файлаcontent(строка): Содержимое файла
редактировать_файл
Вносите выборочные изменения, используя расширенное сопоставление с образцом и форматирование.
Функции:
Сопоставление содержимого по строкам и по нескольким строкам
Нормализация пробелов с сохранением отступов
Несколько одновременных правок с правильным позиционированием
Определение и сохранение стиля отступа
Вывод различий в стиле Git с контекстом
Предварительный просмотр изменений в режиме пробного прогона
Входные данные:
path(строка): Файл для редактированияedits(массив): Список операций редактированияoldText(строка): Текст для поиска (может быть подстрокой)newText(строка): Текст для замены
dryRun(логическое значение): предварительный просмотр изменений без их применения (по умолчанию: false)
Возвращает подробную информацию о различиях и соответствиях для пробных прогонов, в противном случае применяет изменения
Лучшая практика: всегда сначала используйте dryRun для предварительного просмотра изменений перед их применением.
создать_каталог
Создайте новый каталог или убедитесь, что он существует
Ввод:
path(строка)При необходимости создает родительские каталоги.
Выполняется без уведомления, если каталог существует
список_каталогов
Список содержимого каталога с префиксами [FILE] или [DIR]
Ввод:
path(строка)
переместить_файл
Перемещать или переименовывать файлы и каталоги
Входные данные:
source(строка)destination(строка)
Не удается, если пункт назначения существует
поиск_файлов
Рекурсивный поиск файлов/каталогов
Входные данные:
path(строка): Начальный каталогpattern(строка): Шаблон поискаexcludePatterns(string[]): Исключить любые шаблоны. Поддерживаются форматы Glob.
Сопоставление без учета регистра
Возвращает полные пути к совпадениям
получить_информацию_о_файле
Получить подробные метаданные файла/каталога
Ввод:
path(строка)Возврат:
Размер
Время создания
Измененное время
Время доступа
Тип (файл/каталог)
Разрешения
список_разрешенных_каталогов
Список всех каталогов, к которым серверу разрешен доступ
Ввод не требуется
Возврат:
Каталоги, которые этот сервер может читать/писать
Использование с Claude Desktop
Добавьте это в ваш claude_desktop_config.json :
Примечание: вы можете предоставить изолированные каталоги серверу, смонтировав их в /projects . Добавление флага ro сделает каталог доступным только для чтения сервером.
Докер
Примечание: по умолчанию все каталоги должны быть смонтированы в /projects .
{
"mcpServers": {
"filesystem": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--mount", "type=bind,src=/Users/username/Desktop,dst=/projects/Desktop",
"--mount", "type=bind,src=/path/to/other/allowed/dir,dst=/projects/other/allowed/dir,ro",
"--mount", "type=bind,src=/path/to/file.txt,dst=/projects/path/to/file.txt",
"mcp/filesystem",
"/projects"
]
}
}
}
НПХ
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Desktop",
"/path/to/other/allowed/dir"
]
}
}
}
Использование с VS Code
Для быстрой установки нажмите кнопки установки ниже...
Для ручной установки добавьте следующий блок JSON в файл настроек пользователя (JSON) в VS Code. Это можно сделать, нажав Ctrl + Shift + P и введя Preferences: Open Settings (JSON) .
При желании вы можете добавить его в файл .vscode/mcp.json в вашем рабочем пространстве. Это позволит вам поделиться конфигурацией с другими.
Обратите внимание, что ключ
mcpне нужен в файле.vscode/mcp.json.
Вы можете предоставить изолированные каталоги серверу, смонтировав их в /projects . Добавление флага ro сделает каталог доступным только для чтения сервером.
Докер
Примечание: по умолчанию все каталоги должны быть смонтированы в /projects .
{
"mcp": {
"servers": {
"filesystem": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--mount", "type=bind,src=${workspaceFolder},dst=/projects/workspace",
"mcp/filesystem",
"/projects"
]
}
}
}
}
НПХ
{
"mcp": {
"servers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"${workspaceFolder}"
]
}
}
}
}
Строить
Сборка Docker:
docker build -t mcp/filesystem -f src/filesystem/Dockerfile .
Лицензия
Этот сервер MCP лицензирован по лицензии MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT. Для получения более подробной информации см. файл LICENSE в репозитории проекта.
Related MCP Servers
- -securityAlicense-qualityNode.js server implementing Model Context Protocol for secure read-only filesystem operations, allowing Claude to read files, list directories, search files, and get file metadata within specified directories.Last updated -113MIT License
- AsecurityFlicenseAqualityNode.js server implementing Model Context Protocol (MCP) for filesystem operations with comprehensive permission controls, allowing secure file and directory manipulation with granular access restrictions.Last updated -2175,5413
- -security-license-qualityNode.js server implementing Model Context Protocol (MCP) for filesystem operations, allowing AI systems to read, write, edit files and manage directories within specified allowed paths.Last updated -75,541MIT License