MF

MCPIgnore Filesytem

Created 5 months ago

Protect your most sensitive data by using this data security first filesystem.

development documentation public

What is MCPIgnore Filesytem?

A Data Security First filesystem MCP server that implements .mcpignore to prevent MCP clients from accessing sensitive data.

Documentation

Filesystem MCP Server with .mcpignore support

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

Configuring .mcpignore

The .mcpignore file uses the same patterns as .gitignore

Patterns Examples

.env\n\n# Ignore all files with a `.safetensor` extension
*.safetensors\n\n# 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.

Server Config

{
  "mcpServers": {
    "mcpignore-filesytem-server": {
      "command": "npx",
      "args": [
        "mcpignore-filesytem"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: Yes

Project Info

Hosted Featured
Created At: Jul 02, 2025
Updated At: Aug 07, 2025
Author: Cyberhaven Inc.
Category: community
License: MIT License
Tags:
development documentation public