CodeSeeker

Advanced code search and transformation for AI assistants

A comprehensive Model Context Protocol (MCP) server that combines the power ofugrepandast-grepphilosophies to deliver intelligent search and replace capabilities for modern development workflows.

git clone https://github.com/Genivia/ugrep.git cd ugrep ./configure make sudo make install

ugrep --version # Should show version 7.4 or higher

node --version # Should show v18.0.0 or higher

git clone https://github.com/yourusername/codeseeker-mcp.git cd codeseeker-mcp npm install npm run build

npm test # Should show all tests passing

{ "mcpServers": { "codeseeker": { "command": "node", "args": ["/absolute/path/to/codeseeker-mcp/build/index.js"] } } }

Note: Replace/absolute/path/to/codeseeker-mcpwith the actual path to your installation.

Search for "function" in JavaScript files: - Pattern: function - File Types: js,ts - Path: ./src - Case Sensitive: false

Find TODO items that are urgent but not marked as later: - Query: TODO AND urgent -NOT later - File Types: cpp,h,js,py

Find "function" with up to 2 character errors (matches "functoin", "functio", etc.): - Pattern: function - Max Errors: 2 - File Types: js,ts,py

Replace old function names with new ones (safe preview first): - Pattern: oldFunctionName - Replacement: newFunctionName - File Types: js,ts - Dry Run: true (preview changes) - Backup: true (create backups)

Multiple replacements in one operation: - Replace "var " with "const " - Replace "== " with "=== " - File Types: js,ts - Dry Run: true

Refactor function names across a codebase: - Structure Type: function - Old Pattern: getUserData - New Pattern: fetchUserData - Language: typescript - Dry Run: true

Standard pattern search with filtering options.

- pattern(required): Search pattern or regex
- path(optional): Directory to search (default: current directory)
- caseSensitive(optional): Case-sensitive search (default: false)
- fileTypes(optional): Comma-separated file types (e.g., "js,py,cpp")
- excludeTypes(optional): File types to exclude
- contextLines(optional): Lines of context around matches
- maxResults(optional): Maximum results (default: 100)

Google-like search with boolean operators.

- query(required): Boolean query (supports AND, OR, NOT, parentheses)
- path,fileTypes,maxResults: Same as basic search

- "error AND (critical OR fatal)"
- "TODO AND urgent -NOT completed"
- "function OR method -NOT test"

- pattern(required): Pattern to search for
- maxErrors(optional): Character errors allowed 1-9 (default: 2)
- path,fileTypes,maxResults: Same as basic search

- pattern(required): Search pattern
- path,maxResults: Same as basic search
- archiveTypes(optional): Archive types to search

- structureType(required): Type to search for (function, class, method, import, variable)
- name(optional): Specific name to search for
- language(required): Programming language (js, ts, py, java, cpp)
- path,maxResults: Same as basic search

- initialPattern(optional): Starting search pattern
- path(optional): Starting directory

- pattern(required): Search pattern or regex
- replacement(required): Replacement text (supports $1, $2 capture groups)
- path(optional): Directory to process (default: current directory)
- fileTypes(optional): File types to include
- caseSensitive(optional): Case-sensitive search (default: false)
- dryRun(optional): Preview mode (default: true)
- maxFiles(optional): Maximum files to process (default: 50)
- backup(optional): Create backups (default: true)

- replacements(required): Array of {pattern, replacement, description} objects
- path,fileTypes,caseSensitive,dryRun,backup: Same as search_and_replace

- structureType(required): Code structure type (function, class, variable, import)
- oldPattern(required): Pattern to find
- newPattern(required): Replacement pattern
- language(required): Programming language (js, ts, py, java, cpp)
- path,dryRun,backup: Same as search_and_replace

Get all supported file types for filtering.

Get detailed search statistics and performance metrics.

codeseeker-mcp/ ├── src/ │ └── index.ts # Main server implementation ├── build/ # Compiled JavaScript output ├── package.json # Node.js dependencies and scripts ├── tsconfig.json # TypeScript configuration ├── test.js # Test suite ├── README.md # This file └── SETUP.md # Quick setup guide

npm run build # Compile TypeScript npm run dev # Watch mode for development npm run inspector # Debug with MCP inspector

# Test basic functionality npm test # Use MCP inspector for interactive testing npm run inspector # Test with Claude Desktop # (Add to config and restart Claude Desktop)

All replace operations default todry-run modefor safety:

- Preview changes before applying
- See exactly what will be modified
- No accidental overwrites

- Backup files created automatically with timestamps
- Original files preserved
- Easy rollback if needed

- Comprehensive error messages
- Graceful failure handling
- File permission checking

- Ensure ugrep is installed and in your PATH
- Runugrep --versionto verify installation

- Make sure the build/index.js file is executable
- Runchmod +x build/index.js(on Unix systems)

- Runnpm installto install dependencies
- Ensure you're using Node.js 18 or higher

"Claude Desktop not showing tools"

- Verify the configuration file path is correct
- Restart Claude Desktop after configuration changes
- Check Claude Desktop logs for connection errors

- Check that the path exists and contains matching files
- Verify file type filters are correct
- Ensure ugrep can access the specified directories

- ugrep is extremely fast, often outperforming other grep tools
- JSON output adds minimal overhead
- Archive searching may be slower depending on compression
- Large result sets are limited bymaxResultsparameter
- Replace operations process files efficiently with streaming
- Interactive mode requires a terminal and cannot run through MCP
- Fork the repository
- Create a feature branch (git checkout -b feature/amazing-feature)
- Commit your changes (git commit -m 'Add some amazing feature')
- Push to the branch (git push origin feature/amazing-feature)
- Open a Pull Request

MIT License - see theLICENSEfile for details.

- ugrep- The ultra-fast grep replacement
- ast-grep- AST-based code search and rewrite tool
- Model Context Protocol- Open standard for AI-data connections
- Claude Desktop- AI assistant with MCP support

An MCP server that gives AI agents deep understanding of C# codebases via Roslyn — type search, dependency graphs, usage analysis, and architecture overviews, all from a live in-memory compilation.