mcp-registry/mcp-filesystem-server

    ==================
      
       /// MCP ///
      /// MCP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

mcp-filesystem-server

by mark3labs

Go server implementing the Model Context Protocol (MCP) to expose secure filesystem operations (read, write, copy, move, delete, search, etc.) as resources/tools.

471
69
Open Source
GitHubDocumentation

Installation

1. Prerequisites
• Go 1.21+ installed and GOPATH/GOROOT configured
• Git for cloning the repository
2. Clone source
git clone https://github.com/mark3labs/mcp-filesystem-server.git cd mcp-filesystem-server
3. Build & install binary (recommended)
go install ./cmd/mcp-fs-server@latest # installs into $(go env GOPATH)/bin
or run straight from source:
go run ./cmd/mcp-fs-server --help
4. Minimal configuration
Create a YAML/JSON file (e.g. config.yaml):
server: listen: ":8000" # TCP address the MCP server will bind to filesystem: rootDir: "/var/mcp-data" # Directory the server is allowed to expose auth: token: "<your-bearer-token>" # Optional access token for secured calls
5. Start the server
mcp-fs-server --config ./config.yaml
6. Docker (alternative)
docker build -t mark3labs/mcp-fs-server . docker run -d -p 8000:8000 -v $PWD/data:/var/mcp-data mark3labs/mcp-fs-server
7. Test connectivity
curl http://localhost:8000/healthz
Should return `OK`.

Documentation

License: MIT License
Updated 7/30/2025