# SuperGrep MCP server

> Enables AI coding agents to perform hybrid keyword, semantic, and SQL searches over local or cloud-hosted codebases and logs.

- Repository: https://github.com/infino-ai/code-context
- Page: https://hostedmcp.org/servers/infino-ai/code-context
- Transport: stdio
- Stars: 31
- License: Apache-2.0
- Latest version: 0.5.1

## Install

### Claude Code

```sh
claude mcp add code-context -- npx -y @infino-ai/code-context
```

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

```json
{
  "mcpServers": {
    "code-context": {
      "command": "npx",
      "args": [
        "-y",
        "@infino-ai/code-context"
      ]
    }
  }
}
```

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

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

### VS Code CLI

```sh
code --add-mcp '{"name":"code-context","type":"stdio","command":"npx","args":["-y","@infino-ai/code-context"]}'
```

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

```json
{
  "mcpServers": {
    "code-context": {
      "command": "npx",
      "args": [
        "-y",
        "@infino-ai/code-context"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add code-context -- npx -y @infino-ai/code-context
```

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

```toml
[mcp_servers.code-context]
command = "npx"
args = ["-y", "@infino-ai/code-context"]
```

### Gemini CLI

```sh
gemini mcp add -s user code-context npx -- -y @infino-ai/code-context
```

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

```json
{
  "mcpServers": {
    "code-context": {
      "command": "npx",
      "args": [
        "-y",
        "@infino-ai/code-context"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `CX_AUTO_SYNC` | no | no | Set to 0 to disable the background staleness sync that runs as queries arrive. |
| `CX_INDEX_DIR` | no | no | Where the index lives. Optional - defaults to .infino/ inside the repository root. |
| `CX_NO_EMBED` | no | no | Set (1/true/yes) for keyword-only mode - skip the vector stage entirely. |
| `CX_NO_RECEIPT` | no | no | Set (1/true/yes) to turn off local usage accounting: the per-call receipt on results and the cx usage ledger. Optional - on by default, computed locally, nothing leaves the machine. |
| `CX_ROOT` | no | no | Repository root to serve. Optional - defaults to the working directory the server is launched in. |

## Tools (2)

- `tables`
- `hydrate`

## FAQ

### What tools does SuperGrep provide to an agent?

It provides three tools: `find` for exact string matching, `search` for ranked semantic similarity, and `sql` for read-only SQL queries over the index.

### Does using SuperGrep cost more for my AI model?

No, it typically reduces costs by allowing the model to query an index rather than reading large files into its context window.

### Is my data uploaded to the cloud automatically?

Only the semantic search functionality requires cloud usage; local keyword searches run on your machine, and data is only uploaded to Infino if you use the `search` tool.