**Empower 당신의 AI 대리인은 튼튼한, platform-agnostic 파일 시스템 기능, 지금 STDIO & Streamable HTTP 수송 선택권으로. **

이 모델 Context Protocol (MCP) 서버는 로컬 파일 시스템과 상호 작용하는 AI 에이전트에 대한 안전하고 신뢰할 수있는 인터페이스를 제공합니다. 그것은 포괄적인 로깅, 오류 처리, 보안 측정을 특징으로하는 생산 읽기, 쓰기, 업데이트 및 관리 파일 및 디렉터리에 의해 백업, 이제 모두 지원 ** STDIO 및 HTTP 운송**.

내용 표

• 개요
• 특징
• 설치
• 구성
• MCP 클라이언트와 사용
• 사용 가능한 도구
• 프로젝트 구조
• 개발
• 라이센스

개요

Model Context Protocol (MCP)은 표준 프레임 워크로 외부 도구 및 데이터 소스 (resources)와 안전하게 상호 작용할 수 있습니다. 이 서버는 MCP 표준을 구현하여 도구로 필수 파일 시스템 작업을 노출하고 AI 에이전트를 활성화합니다.

• 파일 내용을 읽고 분석합니다.
• 생성, 수정, 또는 삭제 파일.
• 이사 및 파일 경로 관리.
• 파일 내의 대상 업데이트 수행.

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"]