j0hanz/filesystem-context-mcp-server

• filesobject[]обязательный

  List of files to create (max 100); each entry requires path and content

• ignoreIfNotExistsboolean

  Silently succeed if a path does not exist instead of returning an error

• pathsstring[]обязательный

  Paths to delete (max 1000); accepts files, directories, or symlinks

• recursiveboolean

  Delete directory contents recursively (required for non-empty directories)

• astringобязательный

  First file to compare

• bstringобязательный

  Second file to compare

• contextinteger

  Number of context lines surrounding each change (default: 3)

• dryRunboolean

  Preview diffs without writing to disk (default: false = apply edits)

• editsany[]

  Replacements applied to path; not allowed when using files

• filesobject[]

  Per-file entries (batch mode)

• ignoreWhitespaceboolean

  Ignore leading/trailing whitespace differences when matching oldText

• pathstring

  Single file path; mutually exclusive with files

• cursorstring

  Opaque pagination cursor; pass unchanged for the next page. Pages slice one snapshot taken on the first call; it expires after ~60s — re-request without a cursor if rejected.

• includeHiddenboolean

  Include hidden items (starting with .)

• includeIgnoredboolean

  Include ignored items (node_modules, .git, etc).

• maxDepthinteger

  Max directory depth to scan; 0 = base directory only, omit for unlimited

• maxResultsinteger

  Maximum number of matching files to return per page

• pathstring

  Base directory to search under (default: first allowed root)

• patternstringобязательный

  Glob pattern to match file paths (e.g. /*.ts, src//*.js)

• sortByenum

  Sort order: path = full path (default), name = basename only

• cursorstring

  Opaque pagination cursor; pass unchanged for the next page. Pages slice one snapshot taken on the first call; it expires after ~60s — re-request without a cursor if rejected.

• includeHiddenboolean

  Include hidden items (starting with .)

• includeIgnoredboolean

  Include ignored items (node_modules, .git, etc).

• maxDepthinteger

  Max directory depth to traverse (default: 1 = top-level only; increase to recurse deeper)

• maxEntriesinteger

  Page size (default: 1000). Continue with nextCursor; resourceUri is only for hard-cap overflow.

• pathstring

  Directory to list (default: first allowed root)

Без параметров.

• copyboolean

  Copy instead of move; sources are left in place

• movesobject[]обязательный

  Operations to perform (max 100)

• overwriteboolean

  Copy mode only: overwrite existing destinations without confirmation

• diffstringобязательный

  Single-file unified diff to apply (as produced by the diff tool or edit dry-run)

• dryRunboolean

  Preview the result without writing (default: false)

• pathstringобязательный

  File to apply the diff to

• endLineinteger

  End line (1-indexed)

• headinteger

  Return first N lines

• includeHashboolean

  Include SHA-256 hash of the returned content in the response

• pathstring

  Single file path; mutually exclusive with paths

• pathsstring[]

  Array of file paths for batch mode (max 1000); mutually exclusive with path

• startLineinteger

  Start line (1-indexed)

• tailinteger

  Return last N lines

• caseSensitiveboolean

  Enable case-sensitive matching (default: case-insensitive)

• dryRunboolean

  Preview replacements without writing to disk (default: false = apply changes)

• includeHiddenboolean

  Include hidden items (starting with .)

• includeIgnoredboolean

  Include ignored items (node_modules, .git, etc).

• isRegexboolean

  Treat searchPattern as a RE2 regex (default: literal text match)

• maxDepthinteger

  Max directory depth to scan; 0 = base directory only, omit for unlimited

• maxFilesinteger

  Maximum number of files to process

• maxResultsinteger

  Maximum total match count across all files before stopping

• pathstring

  File to rewrite, or directory to rewrite under. Omitting it targets the ENTIRE first allowed root — scope it deliberately, and pair a wide scope with dryRun=true first

• patternstring

  Glob to restrict replacements to specific file types (e.g. **/*.ts); default: all text files

• replacementstringобязательный

  Replacement text. Use capture group references ($1, $2, etc.) when isRegex=true. Use an empty string to delete all matches.

• returnDiffboolean

  Include a unified diff of all changes in the response

• searchPatternstringобязательный

  Exact literal text or RE2 regex pattern to search for. When isRegex=true, uses RE2 syntax (no lookahead, lookbehind, or backreferences are supported). Cannot be empty or whitespace-only.

• wholeWordboolean

  Match whole words only (word boundary anchoring)

• caseSensitiveboolean

  Enable case-sensitive matching (default: case-insensitive)

• cursorstring

  Opaque pagination cursor; pass unchanged for the next page. Pages slice one snapshot taken on the first call; it expires after ~60s — re-request without a cursor if rejected.

• includeHiddenboolean

  Include hidden items (starting with .)

• includeIgnoredboolean

  Include ignored items (node_modules, .git, etc).

• isRegexboolean

  Treat searchPattern as a regex (default: literal text match)

• maxDepthinteger

  Max directory depth to scan; 0 = base directory only, omit for unlimited

• maxResultsinteger

  Maximum number of matching lines to return per page

• pathstring

  File to search, or directory to search under (default: the whole first allowed root). Naming a file searches that file alone: pattern is ignored and hidden/ignored filtering does not apply.

• patternstring

  Glob to restrict search to specific file types (e.g. **/*.ts); default: all text files

• searchPatternstringобязательный

  Exact literal text or RE2 regex pattern to search for in file contents. When isRegex=true, uses RE2 syntax (no lookahead, lookbehind, or backreferences). Cannot be empty or whitespace-only.

• pathstring

  Single file path; mutually exclusive with paths

• pathsstring[]

  Array of file paths for batch mode (max 1000); mutually exclusive with path