@j0hanz/filesystem-context-mcp 1.3.0 → 1.3.2

package/dist/config/types.d.ts

@@ -26,10 +26,13 @@ export interface ListDirectoryResult {
     entries: DirectoryEntry[];
     summary: {
         totalEntries: number;
+        entriesScanned?: number;
+        entriesVisible?: number;
         totalFiles: number;
         totalDirectories: number;
         maxDepthReached: number;
         truncated: boolean;
+        stoppedReason?: 'maxEntries' | 'aborted';
         skippedInaccessible: number;
         symlinksNotFollowed: number;
     };
@@ -77,70 +80,6 @@ export interface SearchContentResult {
         stoppedReason?: 'maxResults' | 'maxFiles' | 'timeout';
     };
 }
-export interface DirectoryAnalysis {
-    path: string;
-    totalFiles: number;
-    totalDirectories: number;
-    totalSize: number;
-    fileTypes: Record<string, number>;
-    largestFiles: {
-        path: string;
-        size: number;
-    }[];
-    recentlyModified: {
-        path: string;
-        modified: Date;
-    }[];
-    maxDepth: number;
-}
-export interface AnalyzeDirectoryResult {
-    analysis: DirectoryAnalysis;
-    summary: {
-        truncated: boolean;
-        skippedInaccessible: number;
-        symlinksNotFollowed: number;
-    };
-}
-export interface TreeEntry {
-    name: string;
-    type: 'file' | 'directory';
-    size?: number;
-    children?: TreeEntry[];
-}
-export interface DirectoryTreeResult {
-    tree: TreeEntry;
-    summary: {
-        totalFiles: number;
-        totalDirectories: number;
-        maxDepthReached: number;
-        truncated: boolean;
-        skippedInaccessible: number;
-        symlinksNotFollowed: number;
-    };
-}
-export interface MediaFileResult {
-    path: string;
-    mimeType: string;
-    size: number;
-    data: string;
-}
-export type ChecksumAlgorithm = 'md5' | 'sha1' | 'sha256' | 'sha512';
-export type ChecksumEncoding = 'hex' | 'base64';
-export interface ChecksumResult {
-    path: string;
-    checksum?: string;
-    algorithm: ChecksumAlgorithm;
-    size?: number;
-    error?: string;
-}
-export interface ComputeChecksumsResult {
-    results: ChecksumResult[];
-    summary: {
-        total: number;
-        succeeded: number;
-        failed: number;
-    };
-}
 export interface MultipleFileInfoResult {
     path: string;
     info?: FileInfo;
@@ -155,39 +94,6 @@ export interface GetMultipleFileInfoResult {
         totalSize: number;
     };
 }
-export type DefinitionType = 'function' | 'class' | 'interface' | 'type' | 'enum' | 'variable';
-export interface SearchDefinitionsOptions {
-    path: string;
-    name?: string;
-    type?: DefinitionType;
-    caseSensitive?: boolean;
-    maxResults?: number;
-    excludePatterns?: string[];
-    includeHidden?: boolean;
-    contextLines?: number;
-}
-export interface DefinitionMatch {
-    file: string;
-    line: number;
-    definitionType: DefinitionType;
-    name: string;
-    content: string;
-    contextBefore?: string[];
-    contextAfter?: string[];
-    exported: boolean;
-}
-export interface SearchDefinitionsResult {
-    basePath: string;
-    searchName?: string;
-    searchType?: DefinitionType;
-    definitions: DefinitionMatch[];
-    summary: {
-        filesScanned: number;
-        filesMatched: number;
-        totalDefinitions: number;
-        truncated: boolean;
-    };
-}
 export declare const ErrorCode: {
     readonly E_ACCESS_DENIED: "E_ACCESS_DENIED";
     readonly E_NOT_FOUND: "E_NOT_FOUND";

package/dist/config/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"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"}

package/dist/config/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAoNA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,eAAe,EAAE,iBAAiB;IAClC,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;IACxB,eAAe,EAAE,iBAAiB;IAClC,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,iBAAiB,EAAE,mBAAmB;IACtC,eAAe,EAAE,iBAAiB;IAClC,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,SAAS,EAAE,WAAW;CACd,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AA0GA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,eAAe,EAAE,iBAAiB;IAClC,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;IACxB,eAAe,EAAE,iBAAiB;IAClC,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,iBAAiB,EAAE,mBAAmB;IACtC,eAAe,EAAE,iBAAiB;IAClC,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,SAAS,EAAE,WAAW;CACd,CAAC"}

package/dist/index.js

@@ -1,6 +1,29 @@
 #!/usr/bin/env node
 import { setAllowedDirectoriesResolved } from './lib/path-validation.js';
 import { createServer, parseArgs, startServer } from './server.js';
+const SHUTDOWN_TIMEOUT_MS = 5000;
+let activeServer;
+let shutdownStarted = false;
+async function shutdown(signal) {
+    if (shutdownStarted)
+        return;
+    shutdownStarted = true;
+    const timer = setTimeout(() => {
+        process.exit(0);
+    }, SHUTDOWN_TIMEOUT_MS);
+    try {
+        if (activeServer) {
+            await activeServer.close();
+        }
+    }
+    catch (error) {
+        console.error(`Shutdown error (${signal}):`, error instanceof Error ? error.message : String(error));
+    }
+    finally {
+        clearTimeout(timer);
+        process.exit(0);
+    }
+}
 async function main() {
     const { allowedDirs, allowCwd } = await parseArgs();
     if (allowedDirs.length > 0) {
@@ -11,13 +34,20 @@ async function main() {
         console.error(`No directories specified via CLI. Will use MCP Roots${allowCwd ? ' or current working directory' : ''}.`);
     }
     const server = createServer({ allowCwd, cliAllowedDirs: allowedDirs });
+    activeServer = server;
     await startServer(server);
 }
 process.on('SIGTERM', () => {
-    process.exit(0);
+    void shutdown('SIGTERM');
 });
 process.on('SIGINT', () => {
-    process.exit(0);
+    void shutdown('SIGINT');
+});
+process.stdin.on('end', () => {
+    void shutdown('stdin end');
+});
+process.stdin.on('close', () => {
+    void shutdown('stdin close');
 });
 main().catch((error) => {
     console.error('Fatal error:', error instanceof Error ? error.message : String(error));

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEnE,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,MAAM,SAAS,EAAE,CAAC;IAEpD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,6BAA6B,CAAC,WAAW,CAAC,CAAC;QACjD,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACnD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CACX,uDAAuD,QAAQ,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,EAAE,GAAG,CAC1G,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;IACvE,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CACX,cAAc,EACd,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACjC,IAAI,YAAmC,CAAC;AACxC,IAAI,eAAe,GAAG,KAAK,CAAC;AAE5B,KAAK,UAAU,QAAQ,CAAC,MAAc;IACpC,IAAI,eAAe;QAAE,OAAO;IAC5B,eAAe,GAAG,IAAI,CAAC;IAEvB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,EAAE,mBAAmB,CAAC,CAAC;IAExB,IAAI,CAAC;QACH,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,YAAY,CAAC,KAAK,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CACX,mBAAmB,MAAM,IAAI,EAC7B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,MAAM,SAAS,EAAE,CAAC;IAEpD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,6BAA6B,CAAC,WAAW,CAAC,CAAC;QACjD,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACnD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CACX,uDAAuD,QAAQ,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,EAAE,GAAG,CAC1G,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;IACvE,YAAY,GAAG,MAAM,CAAC;IACtB,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC3B,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC1B,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;IAC3B,KAAK,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC7B,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;IAC7B,KAAK,QAAQ,CAAC,aAAa,CAAC,CAAC;AAC/B,CAAC,CAAC,CAAC;AAEH,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CACX,cAAc,EACd,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/instructions.md

@@ -1,59 +1,65 @@
 # Filesystem Context MCP Server
 
-> **Read-only** tools for exploring directories, searching files, and analyzing codebases via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/).
+> Read-only tools for exploring directories, searching files, and reading
+> content via the Model Context Protocol (MCP).
 
-This server enables AI assistants to safely explore and analyze filesystem contents without modification capabilities. All operations are sandboxed to explicitly allowed directories.
+This server lets assistants inspect files safely. All operations are limited to
+explicitly allowed directories and never write to disk.
 
 ---
 
 ## Quick Reference
 
-| Goal                | Tool                       | Key Parameters                          |
-| ------------------- | -------------------------- | --------------------------------------- |
-| Check access        | `list_allowed_directories` | —                                       |
-| Project structure   | `directory_tree`           | `maxDepth`, `excludePatterns`           |
-| List contents       | `list_directory`           | `recursive`, `sortBy`                   |
-| Directory stats     | `analyze_directory`        | `topN`, `excludePatterns`, `maxEntries` |
-| Find files          | `search_files`             | `pattern` (glob), `maxResults`          |
-| Search in files     | `search_content`           | `pattern` (regex), `contextLines`       |
-| Find definitions    | `search_definitions`       | `name`, `type`, `contextLines`          |
-| Read file           | `read_file`                | `head`, `tail`, `lineStart/lineEnd`     |
-| Read multiple files | `read_multiple_files`      | `paths[]` — **preferred for 2+**        |
-| File metadata       | `get_file_info`            | `path`                                  |
-| Batch file metadata | `get_multiple_file_info`   | `paths[]` — **preferred for 2+**        |
-| Compute checksums   | `compute_checksums`        | `paths[]`, `algorithm`                  |
-| Binary/media files  | `read_media_file`          | `maxSize`                               |
+| Goal                | Tool                       | Key Parameters                      |
+| ------------------- | -------------------------- | ----------------------------------- |
+| Check access        | `list_allowed_directories` | -                                   |
+| List contents       | `list_directory`           | `recursive`, `maxDepth`, `sortBy`   |
+| Find files          | `search_files`             | `pattern` (glob), `maxResults`      |
+| Search in files     | `search_content`           | `pattern` (regex), `contextLines`   |
+| Read file           | `read_file`                | `head`, `tail`, `lineStart/lineEnd` |
+| Read multiple files | `read_multiple_files`      | `paths[]` - preferred for 2+        |
+| File metadata       | `get_file_info`            | `path`                              |
+| Batch file metadata | `get_multiple_file_info`   | `paths[]` - preferred for 2+        |
+
+---
+
+## Core Concepts
+
+- **Allowed directories:** All tools only operate inside the allowed roots.
+  Run `list_allowed_directories` first to confirm scope.
+- **Globs vs regex:** `search_files` uses glob patterns, `search_content` uses
+  regex (set `isLiteral=true` to search for exact text).
+- **Symlinks:** Symlinks are never followed for security. You can request the
+  target path (e.g., `includeSymlinkTargets`) but traversal stays inside roots.
 
 ---
 
 ## Workflows
 
-### Project Discovery
+### Project discovery
 
 ```text
-list_allowed_directories → directory_tree(maxDepth=3) → analyze_directory → read_multiple_files([package.json, README.md])
+list_allowed_directories
+list_directory(path=".", recursive=true, maxDepth=3)
+read_multiple_files(["package.json", "README.md"])
 ```
 
-### Find & Read Code
+### Find and read code
 
 ```text
-search_files(pattern="**/*.ts") → read_multiple_files([...results])
+search_files(pattern="**/*.ts")
+read_multiple_files([...results])
 ```
 
-### Search Patterns
+### Search patterns in code
 
 ```text
 search_content(pattern="TODO|FIXME", filePattern="**/*.ts", contextLines=2)
 ```
 
-### Find Code Definitions
-
-```text
-search_definitions(path="src/", name="User") → Find classes/functions/types named "User"
-search_definitions(path="src/", type="interface") → Discover all interfaces
-```
+---
 
-### Common Glob Patterns
+## Common Glob Patterns
 
 | Pattern               | Matches                                   |
 | --------------------- | ----------------------------------------- |
@@ -69,185 +75,160 @@ search_definitions(path="src/", type="interface") → Discover all interfaces
 
 **Do:**
 
-- Use `read_multiple_files` for 2+ files (parallel, resilient)
-- Set `maxResults`, `maxDepth`, `maxEntries` limits
-- Use `excludePatterns=["node_modules", ".git", "dist"]`
-- Preview with `head=50` before full reads
+- Use `read_multiple_files` for 2+ files (parallel, resilient).
+- Set `maxResults`, `maxDepth`, and `maxEntries` limits.
+- Use `excludePatterns=["node_modules/**", ".git/**", "dist/**"]`.
+- Preview large files with `head=50` before full reads.
 
 **Don't:**
 
-- Loop `read_file` — batch with `read_multiple_files`
-- Recursive search without `maxDepth`
-- Search without `maxResults` on large codebases
+- Loop `read_file` for multiple files.
+- Run recursive searches without `maxDepth`.
+- Search without `maxResults` on large codebases.
 
-## Tool Details
+---
 
-### `directory_tree`
+## Tool Details
 
-JSON tree structure for AI parsing.
+### `list_allowed_directories`
 
-| Parameter         | Default | Description           |
-| ----------------- | ------- | --------------------- |
-| `path`            | —       | Directory path        |
-| `maxDepth`        | 5       | Depth limit (0-50)    |
-| `excludePatterns` | []      | Glob patterns to skip |
-| `includeHidden`   | false   | Include dotfiles      |
-| `includeSize`     | false   | Show file sizes       |
-| `maxFiles`        | —       | Limit total files     |
+List all directories this server can access.
 
-### `search_files`
+| Parameter | Default | Description |
+| --------- | ------- | ----------- |
+| (none)    | -       | -           |
 
-Find files (not directories) by glob pattern.
+---
 
-| Parameter         | Default | Description               |
-| ----------------- | ------- | ------------------------- |
-| `path`            | -       | Base directory            |
-| `pattern`         | -       | Glob: `**/*.ts`, `src/**` |
-| `excludePatterns` | []      | Patterns to skip          |
-| `maxResults`      | -       | Limit (up to 10,000)      |
-| `sortBy`          | "path"  | `name/size/modified/path` |
-| `includeHidden`   | false   | Include dotfiles          |
+### `list_directory`
 
-### `search_content`
+List contents of a directory with optional recursion. Returns entry name,
+relative path, type, size, and modified date. Symlinks are not followed.
 
-Grep-like regex search in files.
-
-| Parameter       | Default | Description               |
-| --------------- | ------- | ------------------------- |
-| `path`          | —       | Base directory            |
-| `pattern`       | —       | Regex: `TODO\|FIXME`      |
-| `filePattern`   | `**/*`  | Glob filter               |
-| `contextLines`  | 0       | Lines before/after (0-10) |
-| `caseSensitive` | false   | Case matching             |
-| `wholeWord`     | false   | Word boundaries           |
-| `isLiteral`     | false   | Escape regex              |
-| `maxResults`    | 100     | Limit matches             |
-| `skipBinary`    | true    | Skip binary files         |
-
-### `search_definitions`
-
-Find code definitions (classes, functions, interfaces, types, enums, variables) without manual regex construction.
-
-| Parameter         | Default | Description                                                                   |
-| ----------------- | ------- | ----------------------------------------------------------------------------- |
-| `path`            | -       | Base directory to search                                                      |
-| `name`            | -       | Definition name to find                                                       |
-| `type`            | -       | Definition type: `class`, `function`, `interface`, `type`, `enum`, `variable` |
-| `caseSensitive`   | true    | Case-sensitive name matching                                                  |
-| `maxResults`      | 100     | Limit matches                                                                 |
-| `excludePatterns` | []      | Glob patterns to exclude                                                      |
-| `includeHidden`   | false   | Include hidden files and directories                                          |
-| `contextLines`    | 0       | Lines of context before/after match (0-10)                                    |
-
-**Usage patterns:**
-
-- **Find by name:** `search_definitions(path="src/", name="UserService")` — finds class/function/type named UserService
-- **Discovery mode:** `search_definitions(path="src/", type="interface")` — lists all interfaces
-- **Combined:** `search_definitions(path="src/", name="Handler", type="class")` — finds classes named "Handler"
+| Parameter               | Default | Description                              |
+| ----------------------- | ------- | ---------------------------------------- |
+| `path`                  | -       | Directory path                           |
+| `recursive`             | false   | Include subdirectories                   |
+| `excludePatterns`       | []      | Glob patterns to skip                    |
+| `pattern`               | -       | Glob pattern to include (relative only)  |
+| `sortBy`                | "name"  | `name/size/modified/type`                |
+| `maxDepth`              | 10      | Depth when recursive                     |
+| `maxEntries`            | 10000   | Limit (up to 100,000)                    |
+| `includeSymlinkTargets` | false   | Include target paths for symlink entries |
 
-### `read_file`
+Structured output note: `entries[].relativePath` is relative to the base path.
 
-Read single file with line selection.
+---
 
-| Parameter    | Default | Description                                         |
-| ------------ | ------- | --------------------------------------------------- |
-| `path`       | -       | File path                                           |
-| `encoding`   | utf-8   | `utf-8/ascii/base64/hex/latin1`                     |
-| `maxSize`    | 10MB    | Size limit                                          |
-| `skipBinary` | false   | Reject binary files (use `read_media_file` instead) |
-| `head`       | -       | First N lines                                       |
-| `tail`       | -       | Last N lines                                        |
-| `lineStart`  | -       | Start line (1-indexed)                              |
-| `lineEnd`    | -       | End line (inclusive)                                |
+### `search_files`
 
-> ⚠️ Cannot combine `head/tail` with `lineStart/lineEnd`
+Find files (not directories) using glob patterns.
+
+| Parameter         | Default  | Description                              |
+| ----------------- | -------- | ---------------------------------------- |
+| `path`            | -        | Base directory                           |
+| `pattern`         | -        | Glob: `**/*.ts`, `src/**`                |
+| `excludePatterns` | built-in | Patterns to skip (pass [] to disable)    |
+| `maxResults`      | 100      | Limit (up to 10,000)                     |
+| `sortBy`          | "path"   | `name/size/modified/path`                |
+| `maxDepth`        | 10       | Maximum depth to scan                    |
+| `maxFilesScanned` | 20000    | Maximum files to scan before stopping    |
+| `timeoutMs`       | 30000    | Timeout in milliseconds                  |
+| `baseNameMatch`   | false    | Match basename for patterns without '/'  |
+| `skipSymlinks`    | true     | Must remain true (symlink traversal off) |
+| `includeHidden`   | false    | Include dotfiles and hidden directories  |
 
-### `read_multiple_files`
+---
 
-Parallel batch reads - failures don't block others.
+### `search_content`
 
-| Parameter   | Default | Description                     |
-| ----------- | ------- | ------------------------------- |
-| `paths`     | -       | Array (max 100)                 |
-| `encoding`  | utf-8   | Encoding for all                |
-| `maxSize`   | 10MB    | Per-file limit                  |
-| `head`      | -       | First N lines each              |
-| `tail`      | -       | Last N lines each               |
-| `lineStart` | -       | Start line (1-indexed) per file |
-| `lineEnd`   | -       | End line (inclusive) per file   |
+Grep-like search across file contents using regex.
+
+| Parameter         | Default  | Description                                |
+| ----------------- | -------- | ------------------------------------------ | ------ |
+| `path`            | -        | Base directory                             |
+| `pattern`         | -        | Regex: `TODO                               | FIXME` |
+| `filePattern`     | `**/*`   | Glob filter for files                      |
+| `excludePatterns` | built-in | Glob patterns to skip (pass [] to disable) |
+| `contextLines`    | 0        | Lines before/after match (0-10)            |
+| `caseSensitive`   | false    | Case-sensitive matching                    |
+| `wholeWord`       | false    | Match whole words only                     |
+| `isLiteral`       | false    | Treat pattern as literal string            |
+| `maxResults`      | 100      | Maximum matches to return                  |
+| `maxFileSize`     | 1MB      | Maximum file size to scan                  |
+| `maxFilesScanned` | 20000    | Maximum files to scan before stopping      |
+| `timeoutMs`       | 30000    | Timeout in milliseconds                    |
+| `skipBinary`      | true     | Skip likely-binary files                   |
+| `includeHidden`   | false    | Include dotfiles and hidden directories    |
+
+Note: `excludePatterns` uses a built-in list of common dependency/build
+folders (e.g., `node_modules`, `dist`, `build`, `coverage`, `.git`, `.vscode`).
+Pass `excludePatterns: []` to disable it.
 
-> ⚠️ Cannot combine `head/tail` with `lineStart/lineEnd`
+---
 
-### `list_directory`
+### `read_file`
 
-Flat listing with metadata.
+Read a single text file with optional line selection.
 
-| Parameter         | Default | Description               |
-| ----------------- | ------- | ------------------------- |
-| `path`            | -       | Directory path            |
-| `recursive`       | false   | Include subdirs           |
-| `excludePatterns` | []      | Patterns to skip          |
-| `pattern`         | -       | Glob to include           |
-| `sortBy`          | "name"  | `name/size/modified/type` |
-| `maxDepth`        | 10      | Depth when recursive      |
-| `maxEntries`      | 10000   | Limit (up to 100,000)     |
+| Parameter    | Default | Description                     |
+| ------------ | ------- | ------------------------------- |
+| `path`       | -       | File path                       |
+| `encoding`   | utf-8   | `utf-8/ascii/base64/hex/latin1` |
+| `maxSize`    | 10MB    | Size limit                      |
+| `skipBinary` | true    | Reject binary files             |
+| `head`       | -       | First N lines                   |
+| `tail`       | -       | Last N lines                    |
+| `lineStart`  | -       | Start line (1-indexed)          |
+| `lineEnd`    | -       | End line (inclusive)            |
 
-**Structured output notes:** `entries[].name` is the basename, and `entries[].relativePath` is the path relative to the listed base.
+Note: `head`/`tail` cannot be combined with `lineStart`/`lineEnd`.
 
-### `analyze_directory`
+---
 
-Statistics: counts, sizes, types, largest/recent files.
+### `read_multiple_files`
 
-| Parameter         | Default | Description         |
-| ----------------- | ------- | ------------------- |
-| `path`            | -       | Directory path      |
-| `maxDepth`        | 10      | Analysis depth      |
-| `topN`            | 10      | Top largest/recent  |
-| `maxEntries`      | 20000   | Max entries scanned |
-| `excludePatterns` | []      | Patterns to skip    |
+Read multiple files in parallel. Each file reports success or error.
 
-### `read_media_file`
+| Parameter      | Default | Description                     |
+| -------------- | ------- | ------------------------------- |
+| `paths`        | -       | Array (max 100)                 |
+| `encoding`     | utf-8   | Encoding for all                |
+| `maxSize`      | 10MB    | Per-file limit                  |
+| `maxTotalSize` | 100MB   | Total size limit across files   |
+| `head`         | -       | First N lines each              |
+| `tail`         | -       | Last N lines each               |
+| `lineStart`    | -       | Start line (1-indexed) per file |
+| `lineEnd`      | -       | End line (inclusive) per file   |
 
-Binary files as base64 with MIME type.
+Note: `head`/`tail` cannot be combined with `lineStart`/`lineEnd`.
 
-| Parameter | Default | Description     |
-| --------- | ------- | --------------- |
-| `path`    | —       | Media file path |
-| `maxSize` | 50MB    | Size limit      |
+---
 
 ### `get_file_info`
 
-Detailed metadata about a file or directory.
+Get metadata about a file or directory without reading contents.
 
 | Parameter | Default | Description               |
 | --------- | ------- | ------------------------- |
-| `path`    | —       | Path to file or directory |
+| `path`    | -       | Path to file or directory |
 
-**Returns:** name, path, type, size, created, modified, accessed, permissions, isHidden, mimeType, symlinkTarget (if applicable).
+Returns: name, path, type, size, created, modified, accessed, permissions,
+isHidden, mimeType, symlinkTarget (if applicable).
+
+---
 
 ### `get_multiple_file_info`
 
-Batch metadata retrieval for multiple files/directories (parallel processing).
+Get metadata for multiple files/directories in parallel.
 
 | Parameter         | Default | Description                 |
 | ----------------- | ------- | --------------------------- |
-| `paths`           | —       | Array of paths (max 100)    |
+| `paths`           | -       | Array of paths (max 100)    |
 | `includeMimeType` | true    | Include MIME type detection |
 
-**Returns:** Array of file info with individual success/error status, plus summary (total, succeeded, failed, totalSize).
-
-### `compute_checksums`
-
-Compute cryptographic hashes for files using streaming (memory-efficient).
-
-| Parameter     | Default | Description                             |
-| ------------- | ------- | --------------------------------------- |
-| `paths`       | —       | Array of file paths (max 50)            |
-| `algorithm`   | sha256  | Hash: `md5`, `sha1`, `sha256`, `sha512` |
-| `encoding`    | hex     | Output: `hex` or `base64`               |
-| `maxFileSize` | 100MB   | Skip files larger than this             |
-
-**Returns:** Array of checksums with file sizes, plus summary. Useful for integrity checks and duplicate detection.
+Returns: Array of file info with individual success/error status, plus
+summary (total, succeeded, failed, totalSize).
 
 ---
 
@@ -256,19 +237,19 @@ Compute cryptographic hashes for files using streaming (memory-efficient).
 | Code                  | Cause                        | Solution                              |
 | --------------------- | ---------------------------- | ------------------------------------- |
 | `E_ACCESS_DENIED`     | Path outside allowed dirs    | Check `list_allowed_directories`      |
-| `E_NOT_FOUND`         | Path doesn't exist           | Verify path with `list_directory`     |
+| `E_NOT_FOUND`         | Path does not exist          | Verify path with `list_directory`     |
 | `E_NOT_FILE`          | Expected file, got directory | Use `list_directory` instead          |
 | `E_NOT_DIRECTORY`     | Expected directory, got file | Use `read_file` instead               |
 | `E_TOO_LARGE`         | File exceeds size limit      | Use `head/tail` or increase `maxSize` |
-| `E_TIMEOUT`           | Operation took too long      | Reduce limits                         |
-| `E_INVALID_PATTERN`   | Malformed glob/regex         | Check glob/regex syntax               |
+| `E_TIMEOUT`           | Operation took too long      | Reduce scope or increase limits       |
+| `E_INVALID_PATTERN`   | Malformed glob/regex         | Check pattern syntax                  |
 | `E_PERMISSION_DENIED` | OS-level access denied       | Check file permissions                |
 
 ---
 
 ## Security
 
-- **Read-only** — no writes, deletes, or modifications
-- **Path validation** — symlinks cannot escape allowed directories
-- **Binary detection** — prevents accidental base64 bloat
-- **Input sanitization** — patterns validated for ReDoS protection
+- Read-only: no writes, deletes, or modifications.
+- Path validation: symlinks cannot escape allowed directories.
+- Binary detection: prevents accidental binary reads.
+- Input sanitization: patterns validated for ReDoS protection.