# Code Crawler MCP server

> Indexes codebases into a SQLite property graph to enable LLMs to perform static and dynamic call tracing and symbol searching.

- Repository: https://github.com/nithin554/code-crawler
- Page: https://hostedmcp.org/servers/nithin554/code-crawler
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.1.90

## Install

### Claude Code

```sh
claude mcp add code-crawler -- npx -y @nithin554/code-crawler
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "code-crawler": {
      "command": "npx",
      "args": [
        "-y",
        "@nithin554/code-crawler"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "code-crawler": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@nithin554/code-crawler"
      ]
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "code-crawler": {
      "command": "npx",
      "args": [
        "-y",
        "@nithin554/code-crawler"
      ]
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.code-crawler]
command = "npx"
args = ["-y", "@nithin554/code-crawler"]
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "code-crawler": {
      "command": "npx",
      "args": [
        "-y",
        "@nithin554/code-crawler"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `CODECRAWLER_BENCH` | no | no |  |
| `CODECRAWLER_BENCH_LINES` | no | no |  |
| `CODECRAWLER_DB` | no | no | Path to the SQLite graph database (default ~/.code-crawler/index.db) |
| `CODECRAWLER_DEFAULT_LIMIT` | no | no | Default result cap for list queries (default 50) |
| `CODECRAWLER_EXCLUDE_DIRS` | no | no | Comma-separated directories to skip during crawl |
| `CODECRAWLER_HELPFUL_ERRORS` | no | no | Fuzzy suggestions on unknown symbols (default true) |
| `CODECRAWLER_MAX_DEPTH` | no | no | Traversal depth cap (default 10) |

## FAQ

### Where is the index stored?

The index is stored in a single SQLite file located at <project>/.code-crawler/index.db.