Файловая система MCP-сервера

Сервер файловой системы 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 (обязательно): Путь к файлу или каталогу
список_разрешенных_каталогов
- Возвращает список каталогов, к которым этому серверу разрешен доступ
- Параметры: Нет

Функции

Безопасный доступ к указанным каталогам
Проверка пути для предотвращения атак обхода каталогов
Разрешение символических ссылок с проверками безопасности
Определение типа 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"
      ]
    }
  }
}

Лицензия

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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Сервер Go реализует протокол контекста модели (MCP) для операций файловой системы.

Related MCP Servers

Filesystem MCP Serverofficial
modelcontextprotocol
-
security
A
license
-
quality
Node.js server implementing Model Context Protocol (MCP) for filesystem operations.
Last updated -
38,532
50,196
Python
MIT License
MCP Local File Reader
sworddut
-
security
A
license
-
quality
A Model Context Protocol (MCP) server that allows AI models to safely access and interact with local file systems, enabling reading file contents, listing directories, and retrieving file metadata.
Last updated -
47
1
JavaScript
MIT License
go-mcp-postgres
guoling2008
-
security
A
license
-
quality
what is go-mcp-postgres? go-mcp-postgres is a Model Context Protocol (MCP) server designed for interacting with Postgres databases, allowing for easy CRUD operations and automation without the need for a Node.js or Python environment.
Last updated -
4
Go
MIT License
file-system-mcp-server
calebmwelsh
-
security
A
license
-
quality
A comprehensive MCP (Model Context Protocol) server for file system operations, providing Claude and other AI assistants with access to local files and directories.
Last updated -
Python
MIT License

View all related MCP servers

Filesystem MCP Server