Skip to main content
Glama
mark3labs

Filesystem MCP Server

by mark3labs

Сервер файловой системы MCP

Этот сервер MCP обеспечивает безопасный доступ к локальной файловой системе через протокол контекста модели (MCP).

Компоненты

Инструменты

Операции с файлами

  • прочитанный_файл

    • Прочитать полное содержимое файла из файловой системы

    • Параметры: path (обязательно): Путь к файлу для чтения

  • прочитать_несколько_файлов

    • Чтение содержимого нескольких файлов за одну операцию

    • Параметры: paths (обязательно): Список путей к файлам для чтения

  • запись_файла

    • Создайте новый файл или перезапишите существующий файл новым содержимым.

    • Параметры: path (обязательно): Путь, куда записать файл, content (обязательно): Содержимое для записи в файл

  • копировать_файл

    • Копировать файлы и каталоги

    • Параметры: source (обязательно): Исходный путь к файлу или каталогу, destination (обязательно): Путь назначения

  • переместить_файл

    • Перемещать или переименовывать файлы и каталоги

    • Параметры: source (обязательно): Исходный путь к файлу или каталогу, destination (обязательно): Путь назначения

  • удалить_файл

    • Удалить файл или каталог из файловой системы

    • Параметры: path (обязательно): путь к файлу или каталогу для удаления, recursive (необязательно): следует ли рекурсивно удалять каталоги (по умолчанию: false)

Операции со справочниками

  • список_каталогов

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

    • Параметры: path (обязательно): Путь к каталогу для просмотра

  • создать_каталог

    • Создайте новый каталог или убедитесь, что каталог существует

    • Параметры: path (обязательно): Путь к создаваемому каталогу.

  • дерево

    • Возвращает иерархическое JSON-представление структуры каталогов.

    • Параметры: path (обязательно): путь к каталогу для перехода, depth (необязательно): максимальная глубина перехода (по умолчанию: 3), follow_symlinks (необязательно): следует ли следовать символическим ссылкам (по умолчанию: false)

Поиск и информация

  • поиск_файлов

    • Рекурсивный поиск файлов и каталогов, соответствующих шаблону

    • Параметры: path (обязательно): Начальный путь для поиска, pattern (обязательно): Шаблон поиска для сопоставления с именами файлов.

  • получить_информацию_о_файле

    • Получить подробные метаданные о файле или каталоге

    • Параметры: path (обязательно): Путь к файлу или каталогу

  • список_разрешенных_каталогов

    • Возвращает список каталогов, к которым этому серверу разрешен доступ

    • Параметры: Нет

Related MCP server: godoc-mcp

Функции

  • Безопасный доступ к указанным каталогам

  • Проверка пути для предотвращения атак обхода каталогов

  • Разрешение символических ссылок с проверками безопасности

  • Определение типа MIME

  • Поддержка текстовых, двоичных и графических файлов

  • Ограничения по размеру для встроенного контента и кодировки base64

Начиная

Установка

Использование Go Install

go install github.com/mark3labs/mcp-filesystem-server@latest

Использование

Как автономный сервер

Запустите сервер MCP с разрешенными каталогами:

mcp-filesystem-server /path/to/allowed/directory [/another/allowed/directory ...]

Как библиотека в вашем проекте Go

package main import ( "log" "os" "github.com/mark3labs/mcp-filesystem-server/filesystemserver" ) func main() { // Create a new filesystem server with allowed directories allowedDirs := []string{"/path/to/allowed/directory", "/another/allowed/directory"} fs, err := filesystemserver.NewFilesystemServer(allowedDirs) if err != nil { log.Fatalf("Failed to create server: %v", err) } // Serve requests if err := fs.Serve(); err != nil { log.Fatalf("Server error: %v", err) } }

Использование с протоколом контекста модели

Чтобы интегрировать этот сервер с приложениями, поддерживающими MCP:

{ "mcpServers": { "filesystem": { "command": "mcp-filesystem-server", "args": ["/path/to/allowed/directory", "/another/allowed/directory"] } } }

Докер

Работа с Docker

Вы можете запустить сервер Filesystem MCP с помощью Docker:

docker run -i --rm ghcr.io/mark3labs/mcp-filesystem-server:latest /path/to/allowed/directory

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

Чтобы интегрировать образ Docker с приложениями, поддерживающими MCP:

{ "mcpServers": { "filesystem": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/mark3labs/mcp-filesystem-server:latest", "/path/to/allowed/directory" ] } } }

Лицензия

Подробную информацию смотрите в файле ЛИЦЕНЗИЯ .

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mark3labs/mcp-filesystem-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server