** Расширьте возможности своих агентов ИИ с помощью надежных, платформенно-агностических возможностей файловой системы, теперь с опциями STDIO и потокового переноса HTTP.

Сервер Model Context Protocol (MCP) обеспечивает безопасный и надежный интерфейс для взаимодействия агентов ИИ с локальной файловой системой. Он позволяет читать, писать, обновлять и управлять файлами и каталогами, поддерживаемыми готовым к производству фондом TypeScript, включающим всестороннюю регистрацию, обработку ошибок, меры безопасности и теперь поддерживающим как **STDIO, так и HTTP-перевозки **.

Таблица содержимого

• Обзор
• Особенности
• Установка
• Конфигурация Использование с MCP-клиентами Доступные инструменты Структура проекта
• Развитие
• Лицензия

Обзор

Model Context Protocol (MCP) — это стандартная структура, позволяющая моделям ИИ безопасно взаимодействовать с внешними инструментами и источниками данных. Этот сервер реализует стандарт MCP для раскрытия основных операций файловой системы в качестве инструментов, позволяющих агентам ИИ:

Чтение и анализ содержимого файлов. Создавать, изменять или перезаписывать файлы.

• Управление каталогами и маршрутами файлов. Выполнять целевые обновления в файлах.

Filesystem MCP Server

Empower your AI agents with robust, platform-agnostic file system capabilities, now with STDIO & Streamable HTTP transport options.

This Model Context Protocol (MCP) server provides a secure and reliable interface for AI agents to interact with the local filesystem. It enables reading, writing, updating, and managing files and directories, backed by a production-ready TypeScript foundation featuring comprehensive logging, error handling, security measures, and now supporting both STDIO and HTTP transports.

Table of Contents

• Overview
• Features
• Installation
• Configuration
• Usage with MCP Clients
• Available Tools
• Project Structure
• Development
• License

Overview

The Model Context Protocol (MCP) is a standard framework allowing AI models to securely interact with external tools and data sources (resources). This server implements the MCP standard to expose essential filesystem operations as tools, enabling AI agents to:

• Read and analyze file contents.
• Create, modify, or overwrite files.
• Manage directories and file paths.
• Perform targeted updates within files.

Built with TypeScript, the server emphasizes type safety, modularity, and robust error handling, making it suitable for reliable integration into AI workflows. It now supports both STDIO for direct process communication and HTTP for network-based interactions.

Architecture

The server employs a layered architecture for clarity and maintainability:

flowchart TB
    subgraph TransportLayer["Transport Layer"]
        direction LR
        STDIO["STDIO Transport"]
        HTTP["HTTP Transport (Express, JWT Auth)"]
    end

    subgraph APILayer["API Layer"]
        direction LR
        MCP["MCP Protocol Interface"]
        Val["Input Validation (Zod)"]
        PathSan["Path Sanitization"]

        MCP --> Val --> PathSan
    end

    subgraph CoreServices["Core Services"]
        direction LR
        Config["Configuration (Zod-validated Env Vars)"]
        Logger["Logging (Winston, Context-aware)"]
        ErrorH["Error Handling (McpError, ErrorHandler)"]
        ServerLogic["MCP Server Logic"]