Skip to content

CyberhavenInc/filesystem-mcpignore

Repository files navigation

Filesystem MCP Server with .mcpignore support

Protect your most sensitive data by using this data security first filesystem. This node.js server builds on top of Filesystem MCP Server and lets you control which files your MCP Client can access using .mcpignore file.

Features

  • Control MCP client's access to your filesystem based on .mcpignore
  • Read/write files
  • Create/list/delete directories
  • Move files/directories
  • Search files
  • Get file metadata

Note: Create an .mcpignore file for each direcoties specified via args

Configuring .mcpignore

The .mcpignore file uses the same patterns as .gitignore

Patterns Examples

# Ignore specific file `.env`
.env

# Ignore all files with a `.safetensor` extension
*.safetensors

# Ignore specific directory, 'assets/logos' and its files
assets/logos/

API

For details, refer to Filesystem MCP Server API Spec

Tool behavior with ignore paths

Tool Behavior
read_file Block
read_multiple_files Block
write_file Block
edit_file Block
create_directory Block
list_directory Block
directory_tree Allow
move_file Block
search_files Allow
get_file_info Block
list_allowed_directories N/A

Note: directory_tree and search_files are allowed only to retrieve the file names

Usage with MCP Clients

  • Claude: Add this to your claude_desktop_config.json
  • Cline: Add this to your cline_mcp_settings.json
  • Cursor: Add this to your mcp.json

Note: .mcpingore applies to the list of allowed directories that you provide as args

NPX

{
    "mcpServers": {
        "mcpignore-filesystem": {
            "command": "npx",
            "args": [
                "-y",
                "@cyberhaven/mcpignore-filesystem",
                "/Users//Desktop",
                "/path/to/other/allowed/dir"
            ]
        }
    }
}

License

This project is licensed under the MIT License. See LICENSE.

Contributing

See CONTRIBUTING.md for information on contributing to this repository.

Security

See SECURITY.md for information on security.

About

No description, website, or topics provided.

Resources

License

Security policy

Stars

Watchers

Forks

Packages

No packages published