{"_id":"@cyberhaven/mcpignore-filesystem","_rev":"5-d3e7ece93a1eef51ee0fbf750525b7b3","name":"@cyberhaven/mcpignore-filesystem","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.1":{"name":"@cyberhaven/mcpignore-filesystem","version":"0.1.1","author":{"name":"Cyberhaven Inc"},"license":"MIT","_id":"@cyberhaven/mcpignore-filesystem@0.1.1","maintainers":[{"name":"vsromanch","email":"vasyl.romanchak@cyberhaven.com"},{"name":"mjeonch","email":"jae.jeon@cyberhaven.com"}],"homepage":"https://github.com/CyberhavenInc/mcpignore-filesystem#readme","bin":{"mcpignore-filesystem":"dist/index.js"},"dist":{"shasum":"3d26811b15fc7780975f5c4aa1f57d68d4a0748f","tarball":"https://registry.npmjs.org/@cyberhaven/mcpignore-filesystem/-/mcpignore-filesystem-0.1.1.tgz","fileCount":4,"integrity":"sha512-w5WimxIaYZ9KrakY4aSldsxkZj6xX84fstPMLv1bQ3TQwLUdKS58DSM5FaLra8gFpFPM9I5Optn2U+cXr4EnoA==","signatures":[{"sig":"MEUCIQCnAxq4rjEPexzn9Ee2udi5TzBF70HHJZVy7nisjhzr0AIgCRUR80+IwTuQ9xMV+RRdaUwrJxzPBvEk4IgIPNOpaRU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":30454},"type":"module","gitHead":"350c7df20a832941475acd9c4b71f74bfbe85159","scripts":{"build":"tsc && shx chmod +x dist/*.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"mjeonch","email":"jae.jeon@cyberhaven.com"},"_npmVersion":"10.8.2","description":"Data security first filesystem MCP server with .mcpignore functionality","directories":{},"_nodeVersion":"20.19.1","dependencies":{"diff":"^5.1.0","glob":"^10.3.10","ignore":"^7.0.4","minimatch":"^10.0.1","zod-to-json-schema":"^3.23.5","@modelcontextprotocol/sdk":"0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","typescript":"^5.3.3","@types/diff":"^5.0.9","@types/node":"^22","@types/minimatch":"^5.1.2"},"_npmOperationalInternal":{"tmp":"tmp/mcpignore-filesystem_0.1.1_1748555061172_0.7945838405333503","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."}},"time":{"created":"2025-05-29T21:44:21.067Z","modified":"2026-04-23T15:57:57.655Z","0.1.0":"2025-05-29T19:25:49.965Z","0.1.1":"2025-05-29T21:44:21.322Z"},"author":{"name":"Cyberhaven Inc"},"license":"MIT","homepage":"https://github.com/CyberhavenInc/mcpignore-filesystem#readme","description":"Data security first filesystem MCP server with .mcpignore functionality","maintainers":[{"name":"mjeonch","email":"jae.jeon@cyberhaven.com"},{"name":"vsromanch","email":"vasyl.romanchak@cyberhaven.com"}],"readme":"# Filesystem MCP Server with `.mcpignore` support\n\n**Protect your most sensitive data by using this data security first filesystem.** This node.js server builds on top of [Filesystem MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem) and lets you control which files your MCP Client can access using `.mcpignore` file. \n\n## Features\n\n- Control MCP client's access to your filesystem based on `.mcpignore`\n- Read/write files\n- Create/list/delete directories\n- Move files/directories\n- Search files\n- Get file metadata \n\nNote: Create an `.mcpignore` file for each direcoties specified via `args`\n\n## Configuring `.mcpignore`\n\nThe `.mcpignore` file uses the same patterns as `.gitignore`\n\n### Patterns Examples\n\n```\n# Ignore specific file `.env`\n.env\n\n# Ignore all files with a `.safetensor` extension\n*.safetensors\n\n# Ignore specific directory, 'assets/logos' and its files\nassets/logos/\n```\n\n## API\n\nFor details, refer to [Filesystem MCP Server API Spec](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem#api)\n\n### Tool behavior with ignore paths\n\n| Tool                     | Behavior | \n| ------------------------ | :------------------------: |\n| read_file                | Block |\n| read_multiple_files      | Block |\n| write_file               | Block |\n| edit_file                | Block |\n| create_directory         | Block |\n| list_directory           | Block |\n| directory_tree           | Allow |\n| move_file                | Block |\n| search_files             | Allow |\n| get_file_info            | Block |\n| list_allowed_directories | N/A   |\n\nNote: `directory_tree` and `search_files` are allowed only to retrieve the file names\n\n## Usage with MCP Clients\n\n- **Claude**: Add this to your `claude_desktop_config.json`\n- **Cline**: Add this to your `cline_mcp_settings.json`\n- **Cursor**: Add this to your `mcp.json`\n\nNote: `.mcpingore` applies to the list of allowed directories that you provide as `args`\n\n### NPX\n\n```json\n{\n    \"mcpServers\": {\n        \"mcpignore-filesystem\": {\n            \"command\": \"npx\",\n            \"args\": [\n                \"-y\",\n                \"@cyberhaven/mcpignore-filesystem\",\n                \"/Users/<username>/Desktop\",\n                \"/path/to/other/allowed/dir\"\n            ]\n        }\n    }\n}\n```\n## License\n\nThis project is licensed under the MIT License. See [LICENSE](LICENSE).\n\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for information on contributing to this repository.\n\n## Security\n\nSee [SECURITY.md](SECURITY.md) for information on security.","readmeFilename":"README.md"}