CodeSeeker MCP Server provides fast, AI-friendly search and safe, language-aware code transformations for development workflows. It combines advanced search capabilities with robust replace and refactor tools, enabling you to locate code patterns, navigate large codebases, and apply precise changes with confidence.

How to use

You interact with the CodeSeeker MCP Server through a client that understands the MCP protocol. Use it to search across your project using basic, boolean, or fuzzy queries, inspect code structure, and preview replacements before applying them. You can run single searches or combine multiple operations in a workflow to refactor code across languages.

How to install

Prerequisites: ensure you have Node.js 18 or newer installed on your machine. You will also need a running environment capable of executing a local MCP server.

Clone the MCP server repository, install dependencies, and build the server. Run the following commands exactly as shown.

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

npm test

Start the server after building (local stdio configuration)

node build/index.js

Note: Start steps may differ if you integrate with a client that uses a startup script; ensure you invoke the final built entry point for the MCP server.

## Configuration and usage notes

You can configure a client to connect to a local MCP server via a stdio connection that starts the server process. The following snippet shows how to configure the integration for a local node-based server.

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

Replace /absolute/path/to/codeseeker-mcp with the actual installation path to the built server.
```
## Examples and practical workflows

Perform a basic search across JavaScript and TypeScript files for a function pattern, then preview results with surrounding context. Use a boolean query to filter for urgent TODOs, and combine with a fuzzy search to catch slightly misspelled identifiers.

## Security and safety

All replace operations default to dry-run mode, showing you exactly what would change before applying modifications. Automatic backups are created for safety, so you can rollback if needed.

## Available tools

### basic\_search

Standard pattern search with file-type filtering and context lines to understand matches.

### boolean\_search

Google-like search supporting AND, OR, NOT with optional parentheses for complex queries.

### fuzzy\_search

Approximate matching that allows character errors to find near-matches.

### archive\_search

Search inside compressed archives (zip, tar, 7z, etc.) without extracting.

### interactive\_search

Launch an interactive TUI mode for real-time search refinement.

### code\_structure\_search

Find code elements like functions, classes, methods, imports, and variables.

### search\_and\_replace

Safe find-and-replace with preview, backup creation, and optional dry-run.

### bulk\_replace

Execute multiple replacements in a single operation.

### code\_refactor

Language-aware refactoring across a codebase.

### list\_file\_types

List all supported file types for filtering.

### get\_search\_stats

Provide detailed metrics and performance data for searches.