MM

mark3labs/mcp-filesystem-server

Deployment & DevOps

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

693 stars 116 forks Качество 69 Тренд 21MIT

Сервер Go, реализующий протокол Model Context Protocol (MCP) для операций с файловой системой.

Обзор

Этот MCP-сервер обеспечивает безопасный доступ к локальной файловой системе через протокол Model Context Protocol (MCP). - - Название: Файловая система - Описание: Доступ к файлам и каталогам в локальной файловой системе - - Чтение полного содержимого файла из файловой системы - Параметры: путь (требуется): путь к файлу для чтения - - Чтение содержимого нескольких файлов за одну операцию - Параметры: пути (требуется): Список путей для чтения файлов - - Создать новый файл или перезаписать существующий файл новым содержимым - Параметры: путь (требуется): Путь для записи файла, содержимое (требуется): Содержимое для записи в файл - - Копирование файлов и каталогов - Параметры: исходный код (требуется): Исходный путь файла или каталога, пункт назначения (требуется): Путь назначения - - Перемещение или переименование файлов и каталогов - Параметры: исходный код (требуется): Исходный путь файла или каталога, пункт назначения (требуется): Путь назначения - - Удаление файла или каталога из файловой системы - Параметры: путь (требуется):...

Обзор (машинный перевод)

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

Компоненты

Ресурсы

  • file://
  • Название: File System
  • Описание: Доступ к файлам и каталогам в локальной файловой системе

Инструменты

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

  • read_file

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

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

  • read_multiple_files

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

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

  • write_file

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

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

  • copy_file

  • Копирование файлов и каталогов

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

  • move_file

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

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

  • delete_file

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

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

MCP Filesystem Server

This MCP server provides secure access to the local filesystem via the Model Context Protocol (MCP).

Components

Resources

  • file://
    • Name: File System
    • Description: Access to files and directories on the local file system

Tools

File Operations

  • read_file

    • Read the complete contents of a file from the file system
    • Parameters: path (required): Path to the file to read
  • read_multiple_files

    • Read the contents of multiple files in a single operation
    • Parameters: paths (required): List of file paths to read
  • write_file

    • Create a new file or overwrite an existing file with new content
    • Parameters: path (required): Path where to write the file, content (required): Content to write to the file
  • copy_file

    • Copy files and directories
    • Parameters: source (required): Source path of the file or directory, destination (required): Destination path
  • move_file

    • Move or rename files and directories
    • Parameters: source (required): Source path of the file or directory, destination (required): Destination path
  • delete_file

    • Delete a file or directory from the file system
    • Parameters: path (required): Path to the file or directory to delete, recursive (optional): Whether to recursively delete directories (default: false)
  • modify_file

    • Update file by finding and replacing text using string matching or regex
    • Parameters: path (required): Path to the file to modify, find (required): Text to search for, replace (required): Text to replace with, all_occurrences (optional): Replace all occurrences (default: true), regex (optional): Treat find pattern as regex (default: false)

Directory Operations

  • list_directory

    • Get a detailed listing of all files and directories in a specified path
    • Parameters: path (required): Path of the directory to list
  • create_directory

    • Create a new directory or ensure a directory exists
    • Parameters: path (required): Path of the directory to create
  • tree

    • Returns a hierarchical JSON representation of a directory structure
    • Parameters: path (required): Path of the directory to traverse, depth (optional): Maximum depth to traverse (default: 3), follow_symlinks (optional): Whether to follow symbolic links (default: false)

Search and Information

  • search_files

    • Recursively search for files and directories matching a pattern
    • Parameters: path (required): Starting path for the search, pattern (required): Search pattern to match against file names
  • search_within_files

    • Search for text within file contents across directory trees
    • Parameters: path (required): Starting directory for the search, substring (required): Text to search for within file contents, depth (optional): Maximum directory depth to search, max_results (optional): Maximum number of results to return (default: 1000)
Открыть полный README на GitHub

Установка

docker run -i --rm ghcr.io/mark3labs/mcp-filesystem-server:latest /path/to/allowed/directory
Новичок в MCP? Начните с руководства на mcpskill.org →

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

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