@sylphx/coderag-mcp

MCP server for intelligent codebase search - RAG-ready for AI assistants.

Quick Start

Using Claude Desktop, VS Code, Cursor, Claude Code, or other MCP clients.

$3

``json { "mcpServers": { "coderag": { "command": "npx", "args": ["-y", "@sylphx/coderag-mcp", "--root=/path/to/project"] } } }`

`$3`


Installation

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:%APPDATA%\Claude\claude_desktop_config.json

`json { "mcpServers": { "coderag": { "command": "npx", "args": ["-y", "@sylphx/coderag-mcp", "--root=/path/to/project"] } } }`

`$3`


Installation
Add to your VS Code settings (JSON):

`json { "mcp": { "servers": { "coderag": { "command": "npx", "args": ["-y", "@sylphx/coderag-mcp", "--root=${workspaceFolder}"] } } } }`

Or add to .vscode/mcp.json in your project:

`json { "servers": { "coderag": { "command": "npx", "args": ["-y", "@sylphx/coderag-mcp", "--root=${workspaceFolder}"] } } }`

`$3`


Installation
Add to your Cursor MCP config:

macOS: ~/.cursor/mcp.jsonWindows:%USERPROFILE%\.cursor\mcp.json

`json { "mcpServers": { "coderag": { "command": "npx", "args": ["-y", "@sylphx/coderag-mcp", "--root=/path/to/project"] } } }`

`$3`


Installation
Add to your Windsurf MCP config:

macOS: ~/.codeium/windsurf/mcp_config.jsonWindows:%USERPROFILE%\.codeium\windsurf\mcp_config.json

`json { "mcpServers": { "coderag": { "command": "npx", "args": ["-y", "@sylphx/coderag-mcp", "--root=/path/to/project"] } } }`

`$3`


Installation

`bash claude mcp add coderag -- npx -y @sylphx/coderag-mcp --root=/path/to/project`

`$3`


Installation
Use the standard config format. All MCP-compatible clients should work with:

`json { "mcpServers": { "coderag": { "command": "npx", "args": ["-y", "@sylphx/coderag-mcp", "--root=/path/to/project"] } } }`

Using bun:

`json { "mcpServers": { "coderag": { "command": "bunx", "args": ["@sylphx/coderag-mcp", "--root=/path/to/project"] } } }`

Global install:

`bash npm install -g @sylphx/coderag-mcp

`or`


bun add -g @sylphx/coderag-mcp

Then use coderag-mcp as the command:

`json { "mcpServers": { "coderag": { "command": "coderag-mcp", "args": ["--root=/path/to/project"] } } }`

`Options`

| Option | Default | Description | |--------|---------|-------------| |--root=| Current directory | Codebase root path | |--max-size=| 1048576 (1MB) | Max file size to index | |--no-auto-index | false | Disable auto-indexing on startup |

`MCP Tool:` codebase_search

Search project source files with TF-IDF ranking.

`$3`

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| |query| string | Yes | - | Search query | |limit| number | No | 10 | Max results | |include_content| boolean | No | true | Include code snippets | |file_extensions| string[] | No | - | Filter by extension | |path_filter| string | No | - | Filter by path | |exclude_paths | string[] | No | - | Exclude paths |

`$3`

`json { "query": "authentication", "limit": 5, "file_extensions": [".ts", ".tsx"], "exclude_paths": ["node_modules", "dist"] }`

`$3`

LLM-optimized output (minimal tokens, maximum content):

`markdown

`Search: "authentication" (3 results)`

`src/auth/login.ts:15-28`

typescript
15: export async function authenticate(credentials) {
16:   const user = await findUser(credentials.email)


docs/auth.md:42-55 [markdown→typescript]

typescript
42: // Embedded code from docs


src/utils/large-file.ts:1-500 [truncated]

typescript
1: // First 70% of content shown...
... [1500 chars truncated] ...

490: // Last 20% of content shown``

`Usage Tips`

Good queries: -user authentication login-database connection-React form validation

Less effective: - Single common words likefunction, const- Very long sentences

`Performance`

| Metric | Value | |--------|-------| | Startup | 1-5 seconds | | Search | <50ms | | Memory | ~1-2 MB per 1000 files |

`Development`

`bash git clone https://github.com/SylphxAI/coderag.git cd coderag

bun install bun run build

`Run locally`


cd packages/mcp-server
bun run dev

License

MIT

---

Powered by Sylphx

Built with @sylphx/coderag · @sylphx/mcp-server-sdk

@sylphx/coderag-mcp

MCP server for intelligent codebase search - RAG-ready for AI assistants.

Quick Start

Using Claude Desktop, VS Code, Cursor, Claude Code, or other MCP clients.

$3

``json { "mcpServers": { "coderag": { "command": "npx", "args": ["-y", "@sylphx/coderag-mcp", "--root=/path/to/project"] } } }`

`$3`


Installation

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:%APPDATA%\Claude\claude_desktop_config.json

`json { "mcpServers": { "coderag": { "command": "npx", "args": ["-y", "@sylphx/coderag-mcp", "--root=/path/to/project"] } } }`

`$3`


Installation
Add to your VS Code settings (JSON):

`json { "mcp": { "servers": { "coderag": { "command": "npx", "args": ["-y", "@sylphx/coderag-mcp", "--root=${workspaceFolder}"] } } } }`

Or add to .vscode/mcp.json in your project:

`json { "servers": { "coderag": { "command": "npx", "args": ["-y", "@sylphx/coderag-mcp", "--root=${workspaceFolder}"] } } }`

`$3`


Installation
Add to your Cursor MCP config:

macOS: ~/.cursor/mcp.jsonWindows:%USERPROFILE%\.cursor\mcp.json

`json { "mcpServers": { "coderag": { "command": "npx", "args": ["-y", "@sylphx/coderag-mcp", "--root=/path/to/project"] } } }`

`$3`


Installation
Add to your Windsurf MCP config:

macOS: ~/.codeium/windsurf/mcp_config.jsonWindows:%USERPROFILE%\.codeium\windsurf\mcp_config.json

`json { "mcpServers": { "coderag": { "command": "npx", "args": ["-y", "@sylphx/coderag-mcp", "--root=/path/to/project"] } } }`

`$3`


Installation

`bash claude mcp add coderag -- npx -y @sylphx/coderag-mcp --root=/path/to/project`

`$3`


Installation
Use the standard config format. All MCP-compatible clients should work with:

`json { "mcpServers": { "coderag": { "command": "npx", "args": ["-y", "@sylphx/coderag-mcp", "--root=/path/to/project"] } } }`

Using bun:

`json { "mcpServers": { "coderag": { "command": "bunx", "args": ["@sylphx/coderag-mcp", "--root=/path/to/project"] } } }`

Global install:

`bash npm install -g @sylphx/coderag-mcp

`or`


bun add -g @sylphx/coderag-mcp

Then use coderag-mcp as the command:

`json { "mcpServers": { "coderag": { "command": "coderag-mcp", "args": ["--root=/path/to/project"] } } }`

`Options`

`MCP Tool:` codebase_search

Search project source files with TF-IDF ranking.

`$3`

`json { "query": "authentication", "limit": 5, "file_extensions": [".ts", ".tsx"], "exclude_paths": ["node_modules", "dist"] }`

`$3`

LLM-optimized output (minimal tokens, maximum content):

`markdown

`Search: "authentication" (3 results)`

`src/auth/login.ts:15-28`

typescript
15: export async function authenticate(credentials) {
16:   const user = await findUser(credentials.email)


docs/auth.md:42-55 [markdown→typescript]

typescript
42: // Embedded code from docs


src/utils/large-file.ts:1-500 [truncated]

typescript
1: // First 70% of content shown...
... [1500 chars truncated] ...

490: // Last 20% of content shown``

`Usage Tips`

Good queries: -user authentication login-database connection-React form validation

Less effective: - Single common words likefunction, const- Very long sentences

`Performance`

| Metric | Value | |--------|-------| | Startup | 1-5 seconds | | Search | <50ms | | Memory | ~1-2 MB per 1000 files |

`Development`

`bash git clone https://github.com/SylphxAI/coderag.git cd coderag

bun install bun run build

`Run locally`


cd packages/mcp-server
bun run dev

License

MIT

---

Powered by Sylphx

Built with @sylphx/coderag · @sylphx/mcp-server-sdk

@sylphx/coderag-mcp

@sylphx/coderag-mcp

Quick Start

$3

$3

$3

$3

$3

$3

$3

or

Options

MCP Tool: codebase_search

$3

$3

$3

Search: "authentication" (3 results)

src/auth/login.ts:15-28

docs/auth.md:42-55 [markdown→typescript]

src/utils/large-file.ts:1-500 [truncated]

Usage Tips

Performance

Development

Run locally

License

@sylphx/coderag-mcp

@sylphx/coderag-mcp

Quick Start

$3

$3

$3

$3

$3

$3

$3

or

Options

MCP Tool: codebase_search

$3

$3

$3

Search: "authentication" (3 results)

src/auth/login.ts:15-28

docs/auth.md:42-55 [markdown→typescript]

src/utils/large-file.ts:1-500 [truncated]

Usage Tips

Performance

Development

Run locally

License

`$3`

`$3`

`$3`

`$3`

`$3`

`$3`

`or`

`Options`

`MCP Tool:` codebase_search

`$3`

`$3`

`$3`

`Search: "authentication" (3 results)`

`src/auth/login.ts:15-28`

`Usage Tips`

`Performance`

`Development`

`Run locally`

`$3`

`$3`

`$3`

`$3`

`$3`

`$3`

`or`

`Options`

`MCP Tool:` codebase_search

`$3`

`$3`

`$3`

`Search: "authentication" (3 results)`

`src/auth/login.ts:15-28`

`Usage Tips`

`Performance`

`Development`

`Run locally`