Сервер файловой системы 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: File Operations MCP Server

Функции

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

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

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

• Определение типа 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"
      ]
    }
  }
}

Лицензия

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