@j0hanz/filesystem-context-mcp 1.0.4 → 1.0.6

package/README.md

@@ -5,7 +5,7 @@ A secure, read-only MCP server for filesystem scanning, searching, and analysis
 [![npm version](https://img.shields.io/npm/v/@j0hanz/filesystem-context-mcp.svg)](https://www.npmjs.com/package/@j0hanz/filesystem-context-mcp)
 [![License](https://img.shields.io/npm/l/@j0hanz/filesystem-context-mcp)](LICENSE)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://www.typescriptlang.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7.2-blue)](https://www.typescriptlang.org/)
 [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-1.12.0-purple)](https://modelcontextprotocol.io)
 
 ## One-Click Install
@@ -196,7 +196,7 @@ Search for files using glob patterns.
 | `path`            | string   | ✅       | -       | Base directory to search from                 |
 | `pattern`         | string   | ✅       | -       | Glob pattern (e.g., `**/*.ts`, `src/**/*.js`) |
 | `excludePatterns` | string[] | ❌       | `[]`    | Patterns to exclude                           |
-| `maxResults`      | number   | ❌       | -       | Maximum matches to return (1-10,000)          |
+| `maxResults`      | number   | ❌       | -       | Maximum matches to return (max 10,000)        |
 | `sortBy`          | string   | ❌       | `path`  | Sort by: `name`, `size`, `modified`, `path`   |
 | `maxDepth`        | number   | ❌       | -       | Maximum directory depth to search (1-100)     |
 
@@ -218,15 +218,15 @@ Search for files using glob patterns.
 
 Read the contents of a text file.
 
-| Parameter   | Type   | Required | Default | Description                                      |
-| ----------- | ------ | -------- | ------- | ------------------------------------------------ |
-| `path`      | string | ✅       | -       | File path to read                                |
-| `encoding`  | string | ❌       | `utf-8` | File encoding (`utf-8`, `ascii`, `base64`, etc.) |
-| `maxSize`   | number | ❌       | 10MB    | Maximum file size in bytes                       |
-| `lineStart` | number | ❌       | -       | Start line (1-indexed) for reading a range       |
-| `lineEnd`   | number | ❌       | -       | End line (inclusive) for reading a range         |
-| `head`      | number | ❌       | -       | Read only first N lines                          |
-| `tail`      | number | ❌       | -       | Read only last N lines                           |
+| Parameter   | Type   | Required | Default | Description                                                |
+| ----------- | ------ | -------- | ------- | ---------------------------------------------------------- |
+| `path`      | string | ✅       | -       | File path to read                                          |
+| `encoding`  | string | ❌       | `utf-8` | File encoding (`utf-8`, `ascii`, `base64`, etc.)           |
+| `maxSize`   | number | ❌       | 10MB    | Maximum file size in bytes                                 |
+| `lineStart` | number | ❌       | -       | Start line (1-indexed, min 1) for reading a range          |
+| `lineEnd`   | number | ❌       | -       | End line (1-indexed, inclusive, min 1) for reading a range |
+| `head`      | number | ❌       | -       | Read only first N lines                                    |
+| `tail`      | number | ❌       | -       | Read only last N lines                                     |
 
 > **Note:** Cannot specify both `head` and `tail` simultaneously. Use `lineStart`/`lineEnd` for range reading.
 
@@ -301,13 +301,13 @@ Search for text content within files using regular expressions.
 
 Analyze a directory structure and return statistics.
 
-| Parameter         | Type     | Required | Default | Description                            |
-| ----------------- | -------- | -------- | ------- | -------------------------------------- |
-| `path`            | string   | ✅       | -       | Directory to analyze                   |
-| `maxDepth`        | number   | ❌       | `10`    | Maximum depth to analyze (0-100)       |
-| `topN`            | number   | ❌       | `10`    | Number of top items to return (1-1000) |
-| `excludePatterns` | string[] | ❌       | `[]`    | Glob patterns to exclude               |
-| `includeHidden`   | boolean  | ❌       | `false` | Include hidden files and directories   |
+| Parameter         | Type     | Required | Default | Description                              |
+| ----------------- | -------- | -------- | ------- | ---------------------------------------- |
+| `path`            | string   | ✅       | -       | Directory to analyze                     |
+| `maxDepth`        | number   | ❌       | `10`    | Maximum depth to analyze (0-100)         |
+| `topN`            | number   | ❌       | `10`    | Number of top items to return (max 1000) |
+| `excludePatterns` | string[] | ❌       | `[]`    | Glob patterns to exclude                 |
+| `includeHidden`   | boolean  | ❌       | `false` | Include hidden files and directories     |
 
 **Returns:** Statistics including total files/directories, total size, file type distribution, largest files, and recently modified files.
 
@@ -317,14 +317,14 @@ Analyze a directory structure and return statistics.
 
 Get a JSON tree structure of a directory, optimized for AI parsing.
 
-| Parameter         | Type     | Required | Default | Description                             |
-| ----------------- | -------- | -------- | ------- | --------------------------------------- |
-| `path`            | string   | ✅       | -       | Directory path to build tree from       |
-| `maxDepth`        | number   | ❌       | `5`     | Maximum depth to traverse (0-50)        |
-| `excludePatterns` | string[] | ❌       | `[]`    | Glob patterns to exclude                |
-| `includeHidden`   | boolean  | ❌       | `false` | Include hidden files and directories    |
-| `includeSize`     | boolean  | ❌       | `false` | Include file sizes in the tree          |
-| `maxFiles`        | number   | ❌       | -       | Maximum total files to include (1-100k) |
+| Parameter         | Type     | Required | Default | Description                                  |
+| ----------------- | -------- | -------- | ------- | -------------------------------------------- |
+| `path`            | string   | ✅       | -       | Directory path to build tree from            |
+| `maxDepth`        | number   | ❌       | `5`     | Maximum depth to traverse (0-50)             |
+| `excludePatterns` | string[] | ❌       | `[]`    | Glob patterns to exclude                     |
+| `includeHidden`   | boolean  | ❌       | `false` | Include hidden files and directories         |
+| `includeSize`     | boolean  | ❌       | `false` | Include file sizes in the tree               |
+| `maxFiles`        | number   | ❌       | -       | Maximum total files to include (max 100,000) |
 
 **Returns:** Hierarchical tree structure with file/directory nodes.
 
@@ -500,6 +500,7 @@ This server implements multiple layers of security:
 src/
 ├── index.ts              # Entry point, CLI argument parsing
 ├── server.ts             # MCP server setup, roots protocol handling
+├── instructions.md       # AI instructions for tool usage (bundled with dist)
 ├── config/
 │   └── types.ts          # Shared TypeScript types
 ├── lib/

package/dist/instructions.md

@@ -0,0 +1,245 @@
+# Filesystem Context MCP Server
+
+> **Read-only** filesystem tools for exploring directories, searching files, and analyzing codebases. All operations are safe and idempotent.
+
+---
+
+## Tool Selection Guide
+
+### Which Tool Should I Use?
+
+| Goal                              | Tool                       | Key Parameters                                    |
+| --------------------------------- | -------------------------- | ------------------------------------------------- |
+| See what directories I can access | `list_allowed_directories` | _(none)_                                          |
+| Visualize project structure       | `directory_tree`           | `maxDepth`, `excludePatterns`, `includeSize`      |
+| List directory contents           | `list_directory`           | `recursive`, `sortBy`, `maxEntries`               |
+| Get directory statistics          | `analyze_directory`        | `topN`, `excludePatterns`                         |
+| Find files by name/pattern        | `search_files`             | `pattern` (glob), `excludePatterns`, `maxResults` |
+| Search inside file contents       | `search_content`           | `pattern` (regex), `filePattern`, `contextLines`  |
+| Read a single file                | `read_file`                | `head`, `tail`, `lineStart`/`lineEnd`             |
+| Read multiple files               | `read_multiple_files`      | `paths[]`, `head`, `tail`                         |
+| Get file metadata                 | `get_file_info`            | _(path only)_                                     |
+| Read images/binary files          | `read_media_file`          | `maxSize`                                         |
+
+---
+
+## Quick Start Workflow
+
+**Always start here:**
+
+```text
+1. list_allowed_directories         → Know your boundaries
+2. directory_tree(path, maxDepth=3) → See project structure
+3. analyze_directory(path)          → Get statistics
+```
+
+---
+
+## Tool Reference
+
+### `list_allowed_directories`
+
+Returns all directories this server can access. **Call first** to understand scope.
+
+### `directory_tree`
+
+Returns a JSON tree structure—ideal for AI parsing.
+
+| Parameter         | Type     | Default | Description                 |
+| ----------------- | -------- | ------- | --------------------------- |
+| `path`            | string   | —       | Directory to visualize      |
+| `maxDepth`        | number   | 5       | How deep to traverse (0-50) |
+| `excludePatterns` | string[] | []      | Glob patterns to skip       |
+| `includeHidden`   | boolean  | false   | Include dotfiles            |
+| `includeSize`     | boolean  | false   | Show file sizes             |
+| `maxFiles`        | number   | —       | Limit total files returned  |
+
+**Example:** `directory_tree(path, maxDepth=3, excludePatterns=["node_modules", "dist"])`
+
+### `list_directory`
+
+Flat listing with metadata. Use for detailed file information.
+
+| Parameter       | Type    | Default | Description                        |
+| --------------- | ------- | ------- | ---------------------------------- |
+| `path`          | string  | —       | Directory to list                  |
+| `recursive`     | boolean | false   | Include subdirectories             |
+| `sortBy`        | enum    | "name"  | `name`, `size`, `modified`, `type` |
+| `maxDepth`      | number  | 10      | Depth limit when recursive         |
+| `maxEntries`    | number  | —       | Limit results (up to 100,000)      |
+| `includeHidden` | boolean | false   | Include dotfiles                   |
+
+### `analyze_directory`
+
+Statistics: file counts, sizes, types, largest files, recent changes.
+
+| Parameter         | Type     | Default | Description                    |
+| ----------------- | -------- | ------- | ------------------------------ |
+| `path`            | string   | —       | Directory to analyze           |
+| `maxDepth`        | number   | 10      | How deep to analyze            |
+| `topN`            | number   | 10      | Number of largest/recent files |
+| `excludePatterns` | string[] | []      | Patterns to skip               |
+| `includeHidden`   | boolean  | false   | Include dotfiles               |
+
+### `search_files`
+
+Find files by glob pattern. Returns paths, sizes, and modification dates.
+
+| Parameter         | Type     | Default | Description                            |
+| ----------------- | -------- | ------- | -------------------------------------- |
+| `path`            | string   | —       | Base directory                         |
+| `pattern`         | string   | —       | **Glob**: `**/*.ts`, `src/**/test*.js` |
+| `excludePatterns` | string[] | []      | Patterns to skip                       |
+| `maxResults`      | number   | —       | Limit results (up to 10,000)           |
+| `maxDepth`        | number   | —       | Depth limit                            |
+| `sortBy`          | enum     | "path"  | `name`, `size`, `modified`, `path`     |
+
+**Common patterns:**
+
+- `**/*.ts` — All TypeScript files
+- `src/**/*.{js,jsx}` — JS/JSX in src
+- `**/test/**` — All test directories
+- `**/*.test.ts` — Test files by convention
+
+### `search_content`
+
+Grep-like search inside files. Returns matching lines with context.
+
+| Parameter         | Type     | Default | Description                             |
+| ----------------- | -------- | ------- | --------------------------------------- |
+| `path`            | string   | —       | Base directory                          |
+| `pattern`         | string   | —       | **Regex**: `TODO\|FIXME`, `function\s+` |
+| `filePattern`     | string   | `**/*`  | Glob to filter files                    |
+| `excludePatterns` | string[] | []      | Patterns to skip                        |
+| `caseSensitive`   | boolean  | false   | Case-sensitive matching                 |
+| `wholeWord`       | boolean  | false   | Match whole words only                  |
+| `isLiteral`       | boolean  | false   | Treat pattern as literal (not regex)    |
+| `contextLines`    | number   | 0       | Lines before/after match (0-10)         |
+| `maxResults`      | number   | 100     | Limit matches                           |
+| `maxFilesScanned` | number   | —       | Limit files to scan                     |
+| `maxFileSize`     | number   | 1MB     | Skip files larger than this             |
+| `timeoutMs`       | number   | —       | Operation timeout                       |
+| `skipBinary`      | boolean  | true    | Skip binary files                       |
+
+**Example:** `search_content(path, pattern="export (function|class)", filePattern="**/*.ts", contextLines=2)`
+
+### `read_file`
+
+Read a single file with optional line selection.
+
+| Parameter   | Type   | Default | Description                                 |
+| ----------- | ------ | ------- | ------------------------------------------- |
+| `path`      | string | —       | File to read                                |
+| `encoding`  | enum   | "utf-8" | `utf-8`, `ascii`, `base64`, `hex`, `latin1` |
+| `maxSize`   | number | 10MB    | Maximum file size                           |
+| `head`      | number | —       | Read first N lines only                     |
+| `tail`      | number | —       | Read last N lines only                      |
+| `lineStart` | number | —       | Start line (1-indexed)                      |
+| `lineEnd`   | number | —       | End line (inclusive)                        |
+
+**⚠️ Cannot combine:** `head`/`tail` with `lineStart`/`lineEnd`
+
+### `read_multiple_files`
+
+**Preferred for 2+ files** — runs in parallel, individual failures don't block others.
+
+| Parameter  | Type     | Default | Description             |
+| ---------- | -------- | ------- | ----------------------- |
+| `paths`    | string[] | —       | Files to read (max 100) |
+| `encoding` | enum     | "utf-8" | Encoding for all files  |
+| `maxSize`  | number   | 10MB    | Max size per file       |
+| `head`     | number   | —       | First N lines from each |
+| `tail`     | number   | —       | Last N lines from each  |
+
+### `get_file_info`
+
+Metadata only: size, timestamps, permissions, MIME type.
+
+| Parameter | Type   | Description       |
+| --------- | ------ | ----------------- |
+| `path`    | string | File or directory |
+
+### `read_media_file`
+
+Returns binary files as base64 with MIME type. Includes image dimensions.
+
+| Parameter | Type   | Default | Description        |
+| --------- | ------ | ------- | ------------------ |
+| `path`    | string | —       | Path to media file |
+| `maxSize` | number | 50MB    | Maximum file size  |
+
+---
+
+## Efficiency Best Practices
+
+### ✅ Do
+
+- **Batch reads**: Use `read_multiple_files` for 2+ files
+- **Limit scope**: Always set `maxResults`, `maxDepth`, `maxEntries`
+- **Exclude noise**: Use `excludePatterns=["node_modules", ".git", "dist"]`
+- **Preview large files**: Use `head=50` or `tail=50` before full read
+- **Search then read**: `search_files` → `read_multiple_files`
+
+### ❌ Don't
+
+- Call `read_file` in a loop — use `read_multiple_files`
+- Use `recursive=true` without `maxDepth` on large directories
+- Search with `maxResults` unset on large codebases
+- Read entire large files when you only need a section
+
+---
+
+## Common Workflows
+
+### Project Discovery
+
+```text
+list_allowed_directories
+directory_tree(path, maxDepth=3, excludePatterns=["node_modules",".git"])
+analyze_directory(path, excludePatterns=["node_modules"])
+read_multiple_files([package.json, README.md, tsconfig.json])
+```
+
+### Find and Read Code
+
+```text
+search_files(path, pattern="**/*.service.ts")
+read_multiple_files([...results])
+```
+
+### Search Code Patterns
+
+```text
+search_content(path, pattern="async function", filePattern="**/*.ts", contextLines=2)
+```
+
+### Investigate Large Files
+
+```text
+analyze_directory(path)  → See largestFiles
+get_file_info(largefile) → Check exact size
+read_file(largefile, head=100) → Preview beginning
+```
+
+---
+
+## Error Recovery
+
+| Error Code          | Meaning                       | Solution                                    |
+| ------------------- | ----------------------------- | ------------------------------------------- |
+| `E_ACCESS_DENIED`   | Path outside allowed dirs     | Run `list_allowed_directories`              |
+| `E_NOT_FOUND`       | Path doesn't exist            | Use `list_directory` to explore             |
+| `E_NOT_FILE`        | Expected file, got directory  | Use `list_directory` or `directory_tree`    |
+| `E_NOT_DIRECTORY`   | Expected directory, got file  | Use `read_file` or `get_file_info`          |
+| `E_TOO_LARGE`       | File exceeds size limit       | Use `head`/`tail` or increase `maxSize`     |
+| `E_BINARY_FILE`     | Binary file in text operation | Use `read_media_file` instead               |
+| `E_TIMEOUT`         | Operation too slow            | Reduce `maxResults`, `maxDepth`, `maxFiles` |
+| `E_INVALID_PATTERN` | Bad glob/regex syntax         | Check pattern syntax                        |
+
+---
+
+## Security Notes
+
+- **Read-only**: No writes, deletes, or modifications possible
+- **Path validation**: Symlinks cannot escape allowed directories
+- **Binary detection**: Prevents accidental large base64 in text output

package/dist/prompts/analyze-codebase.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAnalyzeCodebasePrompt(server: McpServer): void;
+//# sourceMappingURL=analyze-codebase.d.ts.map

package/dist/prompts/analyze-codebase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-codebase.d.ts","sourceRoot":"","sources":["../../src/prompts/analyze-codebase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkErE"}

package/dist/prompts/analyze-codebase.js

@@ -0,0 +1,58 @@
+import { completable } from '@modelcontextprotocol/sdk/server/completable.js';
+import { z } from 'zod';
+import { getAllowedDirectories } from '../lib/path-validation.js';
+export function registerAnalyzeCodebasePrompt(server) {
+    server.registerPrompt('analyze-codebase', {
+        description: 'Deep analysis of code patterns, architecture, and implementation details in a codebase',
+        argsSchema: {
+            path: completable(z.string().min(1).describe('Root path of the codebase to analyze'), (value) => {
+                const dirs = getAllowedDirectories();
+                return dirs.filter((d) => d.toLowerCase().includes(value.toLowerCase()) ||
+                    value.toLowerCase().includes(d.toLowerCase().slice(0, 10)));
+            }),
+            focus: z
+                .enum(['architecture', 'patterns', 'quality', 'security', 'all'])
+                .optional()
+                .default('all')
+                .describe('Analysis focus area (default: all)'),
+            filePattern: z
+                .string()
+                .optional()
+                .default('**/*.{ts,js,py,java,go,rs}')
+                .describe('Glob pattern for files to analyze (default: common source files)'),
+        },
+    }, ({ path, focus, filePattern }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Perform a deep analysis of the codebase at "${path}" with focus on: ${focus}.
+
+Use the available filesystem tools systematically:
+
+1. **Discovery Phase**
+   - Use \`directory_tree\` to understand the overall structure
+   - Use \`search_files\` with pattern "${filePattern}" to find source files
+   - Use \`analyze_directory\` to get file statistics and identify largest/most recent files
+
+2. **Code Inspection Phase**
+   - Use \`search_content\` to find key patterns:
+     ${focus === 'architecture' || focus === 'all' ? '- Search for class/interface definitions, exports, imports' : ''}
+     ${focus === 'patterns' || focus === 'all' ? '- Search for common design patterns (Factory, Singleton, Observer, etc.)' : ''}
+     ${focus === 'quality' || focus === 'all' ? '- Search for TODO, FIXME, HACK comments' : ''}
+     ${focus === 'security' || focus === 'all' ? '- Search for potential security concerns (eval, exec, password, secret, token)' : ''}
+   - Use \`read_multiple_files\` to examine key files identified in discovery
+
+3. **Analysis Deliverables**
+   ${focus === 'architecture' || focus === 'all' ? '- **Architecture**: Module organization, dependency flow, layering patterns' : ''}
+   ${focus === 'patterns' || focus === 'all' ? '- **Design Patterns**: Identified patterns, their usage, and effectiveness' : ''}
+   ${focus === 'quality' || focus === 'all' ? '- **Code Quality**: Technical debt indicators, documentation coverage, consistency' : ''}
+   ${focus === 'security' || focus === 'all' ? '- **Security**: Potential vulnerabilities, hardcoded secrets, input validation' : ''}
+   - **Recommendations**: Prioritized list of improvements with rationale`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=analyze-codebase.js.map

package/dist/prompts/analyze-codebase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-codebase.js","sourceRoot":"","sources":["../../src/prompts/analyze-codebase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAG9E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC7D,MAAM,CAAC,cAAc,CACnB,kBAAkB,EAClB;QACE,WAAW,EACT,wFAAwF;QAC1F,UAAU,EAAE;YACV,IAAI,EAAE,WAAW,CACf,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC,EAClE,CAAC,KAAK,EAAE,EAAE;gBACR,MAAM,IAAI,GAAG,qBAAqB,EAAE,CAAC;gBACrC,OAAO,IAAI,CAAC,MAAM,CAChB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;oBAC7C,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAC7D,CAAC;YACJ,CAAC,CACF;YACD,KAAK,EAAE,CAAC;iBACL,IAAI,CAAC,CAAC,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;iBAChE,QAAQ,EAAE;iBACV,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CAAC,oCAAoC,CAAC;YACjD,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,OAAO,CAAC,4BAA4B,CAAC;iBACrC,QAAQ,CACP,kEAAkE,CACnE;SACJ;KACF,EACD,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;QACjC,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,+CAA+C,IAAI,oBAAoB,KAAK;;;;;;0CAMpD,WAAW;;;;;OAK9C,KAAK,KAAK,cAAc,IAAI,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,4DAA4D,CAAC,CAAC,CAAC,EAAE;OAC/G,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,0EAA0E,CAAC,CAAC,CAAC,EAAE;OACzH,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,yCAAyC,CAAC,CAAC,CAAC,EAAE;OACvF,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,gFAAgF,CAAC,CAAC,CAAC,EAAE;;;;KAIjI,KAAK,KAAK,cAAc,IAAI,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,6EAA6E,CAAC,CAAC,CAAC,EAAE;KAChI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,4EAA4E,CAAC,CAAC,CAAC,EAAE;KAC3H,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,oFAAoF,CAAC,CAAC,CAAC,EAAE;KAClI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,gFAAgF,CAAC,CAAC,CAAC,EAAE;0EAC1D;iBAC/D;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/prompts/filesystem-query.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerFilesystemQueryPrompt(server: McpServer): void;
+//# sourceMappingURL=filesystem-query.d.ts.map

package/dist/prompts/filesystem-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-query.d.ts","sourceRoot":"","sources":["../../src/prompts/filesystem-query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkIrE"}

package/dist/prompts/filesystem-query.js

@@ -0,0 +1,113 @@
+import { completable } from '@modelcontextprotocol/sdk/server/completable.js';
+import { z } from 'zod';
+import { getAllowedDirectories } from '../lib/path-validation.js';
+export function registerFilesystemQueryPrompt(server) {
+    server.registerPrompt('filesystem-query', {
+        description: 'A guided prompt for performing common filesystem exploration and analysis tasks. Provides structured guidance based on the selected operation type.',
+        argsSchema: {
+            path: completable(z.string().min(1).describe('Target path for the operation'), (value) => {
+                const dirs = getAllowedDirectories();
+                return dirs.filter((d) => d.toLowerCase().includes(value.toLowerCase()) ||
+                    value.toLowerCase().includes(d.toLowerCase().slice(0, 10)));
+            }),
+            operation: z
+                .enum([
+                'explore',
+                'find-files',
+                'search-code',
+                'analyze-size',
+                'recent-changes',
+            ])
+                .describe('Operation type: explore (structure), find-files (by pattern), search-code (content search), analyze-size (disk usage), recent-changes (modified files)'),
+            pattern: z
+                .string()
+                .optional()
+                .describe('Search pattern (glob for find-files, regex for search-code)'),
+            depth: z
+                .number()
+                .int()
+                .min(1)
+                .max(20)
+                .optional()
+                .default(5)
+                .describe('Maximum depth for exploration (default: 5)'),
+        },
+    }, ({ path, operation, pattern, depth }) => {
+        const operationPrompts = {
+            explore: `Explore the filesystem structure at "${path}".
+
+Use these tools in sequence:
+1. \`directory_tree\` with maxDepth=${String(depth)} to visualize the hierarchy
+2. \`analyze_directory\` to get file statistics (types, sizes, counts)
+3. \`list_directory\` with sortBy="modified" for recent activity
+
+Provide:
+- **Structure Overview**: Main directories and their purposes
+- **File Distribution**: Breakdown by type and location
+- **Key Files**: Important configuration or entry point files
+- **Notable Findings**: Unusual patterns or large files`,
+            'find-files': `Find files matching pattern "${pattern ?? '**/*'}" in "${path}".
+
+Use these tools:
+1. \`search_files\` with pattern="${pattern ?? '**/*'}" to find matching files
+2. \`read_multiple_files\` to examine the most relevant matches
+3. Optionally \`get_file_info\` for detailed metadata on specific files
+
+Provide:
+- **Matched Files**: List with paths and sizes
+- **Pattern Analysis**: What the pattern captured
+- **Content Preview**: Summary of matched file contents
+- **Suggestions**: Related patterns that might be useful`,
+            'search-code': `Search for code pattern "${pattern ?? ''}" in "${path}".
+
+Use these tools:
+1. \`search_content\` with pattern="${pattern ?? ''}" and contextLines=2
+2. \`read_multiple_files\` to get full context for important matches
+3. Group results by file and analyze patterns
+
+Provide:
+- **Match Summary**: Total matches, files affected
+- **Code Context**: Key matches with surrounding code
+- **Pattern Usage**: How and where the pattern appears
+- **Related Code**: Suggest related patterns to explore`,
+            'analyze-size': `Analyze disk usage and file sizes in "${path}".
+
+Use these tools:
+1. \`analyze_directory\` to get size statistics and largest files
+2. \`directory_tree\` with includeSize=true for size visualization
+3. \`search_files\` to find specific file types if needed
+
+Provide:
+- **Size Summary**: Total size, file count, directory count
+- **Largest Files**: Top 10 with sizes and paths
+- **Type Breakdown**: Size by file extension
+- **Cleanup Suggestions**: Files that could be removed or compressed`,
+            'recent-changes': `Find recently modified files in "${path}".
+
+Use these tools:
+1. \`analyze_directory\` to see recentlyModified list
+2. \`list_directory\` with sortBy="modified" for detailed listing
+3. \`read_multiple_files\` to examine recent changes
+
+Provide:
+- **Recent Activity**: Files modified in last 24h, week, month
+- **Change Patterns**: Which areas are most active
+- **File Diffs**: Summary of what changed in key files
+- **Activity Insights**: Development patterns or areas of focus`,
+        };
+        const promptText = operationPrompts[operation] ??
+            `Perform "${operation}" operation at "${path}".`;
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: promptText,
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=filesystem-query.js.map

package/dist/prompts/filesystem-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-query.js","sourceRoot":"","sources":["../../src/prompts/filesystem-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAG9E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC7D,MAAM,CAAC,cAAc,CACnB,kBAAkB,EAClB;QACE,WAAW,EACT,qJAAqJ;QACvJ,UAAU,EAAE;YACV,IAAI,EAAE,WAAW,CACf,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAC3D,CAAC,KAAK,EAAE,EAAE;gBACR,MAAM,IAAI,GAAG,qBAAqB,EAAE,CAAC;gBACrC,OAAO,IAAI,CAAC,MAAM,CAChB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;oBAC7C,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAC7D,CAAC;YACJ,CAAC,CACF;YACD,SAAS,EAAE,CAAC;iBACT,IAAI,CAAC;gBACJ,SAAS;gBACT,YAAY;gBACZ,aAAa;gBACb,cAAc;gBACd,gBAAgB;aACjB,CAAC;iBACD,QAAQ,CACP,wJAAwJ,CACzJ;YACH,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,6DAA6D,CAC9D;YACH,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,EAAE;iBACV,OAAO,CAAC,CAAC,CAAC;iBACV,QAAQ,CAAC,4CAA4C,CAAC;SAC1D;KACF,EACD,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QACtC,MAAM,gBAAgB,GAA2B;YAC/C,OAAO,EAAE,wCAAwC,IAAI;;;sCAGvB,MAAM,CAAC,KAAK,CAAC;;;;;;;;wDAQK;YAEhD,YAAY,EAAE,gCAAgC,OAAO,IAAI,MAAM,SAAS,IAAI;;;oCAGhD,OAAO,IAAI,MAAM;;;;;;;;yDAQI;YAEjD,aAAa,EAAE,4BAA4B,OAAO,IAAI,EAAE,SAAS,IAAI;;;sCAGvC,OAAO,IAAI,EAAE;;;;;;;;wDAQK;YAEhD,cAAc,EAAE,yCAAyC,IAAI;;;;;;;;;;;qEAWA;YAE7D,gBAAgB,EAAE,oCAAoC,IAAI;;;;;;;;;;;gEAWF;SACzD,CAAC;QAEF,MAAM,UAAU,GACd,gBAAgB,CAAC,SAAS,CAAC;YAC3B,YAAY,SAAS,mBAAmB,IAAI,IAAI,CAAC;QAEnD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,UAAU;qBACjB;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/prompts/find-duplicates.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerFindDuplicatesPrompt(server: McpServer): void;
+//# sourceMappingURL=find-duplicates.d.ts.map

package/dist/prompts/find-duplicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-duplicates.d.ts","sourceRoot":"","sources":["../../src/prompts/find-duplicates.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8EpE"}

package/dist/prompts/find-duplicates.js

@@ -0,0 +1,68 @@
+import { completable } from '@modelcontextprotocol/sdk/server/completable.js';
+import { z } from 'zod';
+import { getAllowedDirectories } from '../lib/path-validation.js';
+export function registerFindDuplicatesPrompt(server) {
+    server.registerPrompt('find-duplicates', {
+        description: 'Find duplicate or similar code patterns, files, and potential refactoring opportunities',
+        argsSchema: {
+            path: completable(z.string().min(1).describe('Root path to search for duplicates'), (value) => {
+                const dirs = getAllowedDirectories();
+                return dirs.filter((d) => d.toLowerCase().includes(value.toLowerCase()) ||
+                    value.toLowerCase().includes(d.toLowerCase().slice(0, 10)));
+            }),
+            pattern: z
+                .string()
+                .optional()
+                .default('**/*.{ts,js,tsx,jsx,py,java}')
+                .describe('Glob pattern for files to check (default: source files)'),
+            searchTerm: z
+                .string()
+                .optional()
+                .describe('Optional specific pattern or function name to find duplicates of'),
+        },
+    }, ({ path, pattern, searchTerm }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Find duplicate code and refactoring opportunities in "${path}".
+
+Use the available filesystem tools:
+
+1. **File Discovery**
+   - Use \`search_files\` with pattern "${pattern}" to find all relevant files
+   - Use \`analyze_directory\` to identify files of similar sizes (potential duplicates)
+
+2. **Content Analysis**
+   ${searchTerm
+                        ? `- Use \`search_content\` to find all occurrences of "${searchTerm}"`
+                        : `- Use \`search_content\` to find common duplicate patterns:
+     - Similar function signatures
+     - Repeated import statements
+     - Common utility patterns (error handling, logging, validation)
+     - Copied configuration blocks`}
+
+3. **Detailed Inspection**
+   - Use \`read_multiple_files\` to compare files with similar sizes or names
+   - Look for:
+     - Copy-pasted code blocks
+     - Functions with similar logic but different names
+     - Repeated patterns that could be abstracted
+     - Similar error handling or validation logic
+
+4. **Report Findings**
+   - **Exact Duplicates**: Files or code blocks that are identical
+   - **Near Duplicates**: Similar code with minor variations
+   - **Pattern Opportunities**: Repeated patterns that could be abstracted into utilities
+   - **Refactoring Suggestions**: Specific recommendations with:
+     - Which files are affected
+     - Proposed abstraction or consolidation
+     - Estimated complexity reduction
+     - Potential risks of refactoring`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=find-duplicates.js.map

package/dist/prompts/find-duplicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-duplicates.js","sourceRoot":"","sources":["../../src/prompts/find-duplicates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAG9E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,CAAC,cAAc,CACnB,iBAAiB,EACjB;QACE,WAAW,EACT,yFAAyF;QAC3F,UAAU,EAAE;YACV,IAAI,EAAE,WAAW,CACf,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC,EAChE,CAAC,KAAK,EAAE,EAAE;gBACR,MAAM,IAAI,GAAG,qBAAqB,EAAE,CAAC;gBACrC,OAAO,IAAI,CAAC,MAAM,CAChB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;oBAC7C,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAC7D,CAAC;YACJ,CAAC,CACF;YACD,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,OAAO,CAAC,8BAA8B,CAAC;iBACvC,QAAQ,CAAC,yDAAyD,CAAC;YACtE,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,kEAAkE,CACnE;SACJ;KACF,EACD,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QAClC,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,yDAAyD,IAAI;;;;;0CAKrC,OAAO;;;;KAK5C,UAAU;wBACR,CAAC,CAAC,wDAAwD,UAAU,GAAG;wBACvE,CAAC,CAAC;;;;mCAKN;;;;;;;;;;;;;;;;;;sCAkBmC;iBAC3B;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAllPrompts(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAM1D"}

package/dist/prompts/index.js

@@ -0,0 +1,13 @@
+import { registerAnalyzeCodebasePrompt } from './analyze-codebase.js';
+import { registerFilesystemQueryPrompt } from './filesystem-query.js';
+import { registerFindDuplicatesPrompt } from './find-duplicates.js';
+import { registerProjectOverviewPrompt } from './project-overview.js';
+import { registerSearchAndReplacePrompt } from './search-and-replace.js';
+export function registerAllPrompts(server) {
+    registerProjectOverviewPrompt(server);
+    registerAnalyzeCodebasePrompt(server);
+    registerFindDuplicatesPrompt(server);
+    registerSearchAndReplacePrompt(server);
+    registerFilesystemQueryPrompt(server);
+}
+//# sourceMappingURL=index.js.map