base on Go server implementing Model Context Protocol (MCP) for filesystem operations. # MCP Filesystem Server This MCP server provides secure access to the local filesystem via the Model Context Protocol (MCP). ## Components ### 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) - **get_file_info** - Retrieve detailed metadata about a file or directory - Parameters: `path` (required): Path to the file or directory - **list_allowed_directories** - Returns the list of directories that this server is allowed to access - Parameters: None ## Features - Secure access to specified directories - Path validation to prevent directory traversal attacks - Symlink resolution with security checks - MIME type detection - Support for text, binary, and image files - Size limits for inline content and base64 encoding ## Getting Started ### Installation #### Using Go Install ```bash go install github.com/mark3labs/mcp-filesystem-server@latest ``` ### Usage #### As a standalone server Start the MCP server with allowed directories: ```bash mcp-filesystem-server /path/to/allowed/directory [/another/allowed/directory ...] ``` #### As a library in your Go project ```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) } } ``` ### Usage with Model Context Protocol To integrate this server with apps that support MCP: ```json { "mcpServers": { "filesystem": { "command": "mcp-filesystem-server", "args": ["/path/to/allowed/directory", "/another/allowed/directory"] } } } ``` ### Docker #### Running with Docker You can run the Filesystem MCP server using Docker: ```bash docker run -i --rm ghcr.io/mark3labs/mcp-filesystem-server:latest /path/to/allowed/directory ``` #### Docker Configuration with MCP To integrate the Docker image with apps that support MCP: ```json { "mcpServers": { "filesystem": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/mark3labs/mcp-filesystem-server:latest", "/path/to/allowed/directory" ] } } } ``` If you need changes made inside the container to reflect on the host filesystem, you can mount a volume. This allows the container to access and modify files on the host system. Here's an example: ```json { "mcpServers": { "filesystem": { "command": "docker", "args": [ "run", "-i", "--rm", "--volume=/allowed/directory/in/host:/allowed/directory/in/container", "ghcr.io/mark3labs/mcp-filesystem-server:latest", "/allowed/directory/in/container" ] } } } ``` ## License See the [LICENSE](LICENSE) file for details. ", Assign "at most 3 tags" to the expected json: {"id":"13883","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"