@j0hanz/filesystem-mcp 2.5.0 → 2.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +29 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -27,6 +27,21 @@ Filesystem-MCP is a [Model Context Protocol](https://modelcontextprotocol.io) se
|
|
|
27
27
|
| **File subscriptions** | Resource subscriptions push change notifications when watched files update |
|
|
28
28
|
| **Regex safety** | RE2 in all search tools: linear-time matching, so no pattern can ReDoS the server |
|
|
29
29
|
|
|
30
|
+
## Compared with the reference server
|
|
31
|
+
|
|
32
|
+
How this server differs from [`@modelcontextprotocol/server-filesystem`](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem), checked against its README and source on 2026-09-24:
|
|
33
|
+
|
|
34
|
+
| Capability | filesystem-mcp | Reference server |
|
|
35
|
+
| :------------------------ | :----------------------------------------------- | :-------------------------------------- |
|
|
36
|
+
| Search inside files | `search_text`: RE2 regex or literal, linear time | None; `search_files` matches names only |
|
|
37
|
+
| Secret files | `.env`, `*.pem`, `*id_rsa*` denied by default | Not blocked |
|
|
38
|
+
| Read-only mode | `--read-only` removes every mutating tool | Docker `ro` mounts only |
|
|
39
|
+
| Apply a unified diff | `patch` | None |
|
|
40
|
+
| Compare two files | `diff` | None |
|
|
41
|
+
| Replace across many files | `replace_text` over a glob | None |
|
|
42
|
+
| Watch files | Resource subscriptions push change notifications | No resources |
|
|
43
|
+
| Transport | stdio, or Streamable HTTP with `--port` | stdio |
|
|
44
|
+
|
|
30
45
|
## Built with
|
|
31
46
|
|
|
32
47
|
[](https://nodejs.org) [](https://www.typescriptlang.org) [](https://www.docker.com)
|
|
@@ -48,6 +63,7 @@ Filesystem-MCP is a [Model Context Protocol](https://modelcontextprotocol.io) se
|
|
|
48
63
|
- [Scripts](#scripts)
|
|
49
64
|
- [Security](#security)
|
|
50
65
|
- [Contributing](#contributing)
|
|
66
|
+
- [Privacy Policy](#privacy-policy)
|
|
51
67
|
- [License](#license)
|
|
52
68
|
|
|
53
69
|
## Quick start
|
|
@@ -123,7 +139,9 @@ Add to `.vs\mcp.json` in your solution directory, or `%USERPROFILE%\.mcp.json` f
|
|
|
123
139
|
|
|
124
140
|
### Configure in Claude Desktop
|
|
125
141
|
|
|
126
|
-
|
|
142
|
+
One click: download [`filesystem-mcp.mcpb`](https://github.com/j0hanz/filesystem-mcp/releases/latest/download/filesystem-mcp.mcpb), open it with Claude Desktop, and pick the directories to allow. Claude Desktop's built-in Node.js runs it.
|
|
143
|
+
|
|
144
|
+
Or configure it by hand. Add to your `claude_desktop_config.json`:
|
|
127
145
|
|
|
128
146
|
```json
|
|
129
147
|
{
|
|
@@ -454,6 +472,16 @@ filesystem-mcp --port 3000
|
|
|
454
472
|
|
|
455
473
|
[](https://github.com/j0hanz/filesystem-mcp/graphs/contributors)
|
|
456
474
|
|
|
475
|
+
## Privacy Policy
|
|
476
|
+
|
|
477
|
+
filesystem-mcp runs entirely on your machine. This policy covers the npm package, the Docker image, and the `.mcpb` desktop extension.
|
|
478
|
+
|
|
479
|
+
- **Data collection:** none. The server has no telemetry, analytics, or crash reporting, and makes no outbound network requests.
|
|
480
|
+
- **Use and storage:** files are read and written only inside the directories you allow, and only when your MCP client calls a tool. Tool results go to that client and nowhere else. Short-lived result caches live in memory and disappear when the server exits.
|
|
481
|
+
- **Third-party sharing:** none by this server. Your MCP client may send tool results to its model provider under that client's own privacy policy.
|
|
482
|
+
- **Retention:** nothing is kept after the process exits. Diagnostic logs go to stderr on your machine; your MCP client may save them in its own log files.
|
|
483
|
+
- **Contact:** open an issue at <https://github.com/j0hanz/filesystem-mcp/issues>, or report security problems privately through [GitHub Security Advisories](https://github.com/j0hanz/filesystem-mcp/security/advisories).
|
|
484
|
+
|
|
457
485
|
## License
|
|
458
486
|
|
|
459
487
|
Released under the MIT License. See [LICENSE](LICENSE) for details.
|
package/package.json
CHANGED