# miru

Hybrid code search for AI coding agents. It finds relevant chunks by meaning, then hands the agent a path, line numbers and a snippet.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: takara-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/takara-ai/miru-code
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/miru

## What it does

Four tools land in the agent: `search`, `locate`, `expand` and `find_related`. Ask where auth middleware gets configured and miru answers with the chunks that fit, so the agent skips the grep-and-glob loop it usually falls back on.

Setup runs through the CLI: install `@takara-ai/miru-code` globally with Bun, sign in with `miru setup`, then pick integrations in the `miru install` menu. That menu covers the MCP server, instruction files for `CLAUDE.md` and `AGENTS.md`, a sub-agent, and Cursor rules. A plugin marketplace install also exists, though its feature set depends on what each IDE's plugin schema allows. In Cursor the plugin carries skills and rules only, with no MCP entry.

Credentials live per install. A plugin keeps its own copy in the IDE data directory, so signing in through the CLI does not carry over. Run both and you authenticate twice. Either way the server needs `TAKARA_API_KEY` set.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `TAKARA_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add miru -e TAKARA_API_KEY=<TAKARA_API_KEY> -- npx -y @takara-ai/miru-code
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add miru --env TAKARA_API_KEY=<TAKARA_API_KEY> -- npx -y @takara-ai/miru-code
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "miru": {
            "command": "npx",
            "args": [
                "-y",
                "@takara-ai/miru-code"
            ],
            "env": {
                "TAKARA_API_KEY": "<TAKARA_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "miru": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@takara-ai/miru-code"
            ],
            "env": {
                "TAKARA_API_KEY": "<TAKARA_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e TAKARA_API_KEY=<TAKARA_API_KEY> miru npx -y @takara-ai/miru-code
```
Replace <…> with your own values

## When to use it
- locate auth middleware configuration without knowing the filename
- pull in the code around a change instead of reading a whole module
- give the agent context by intent rather than raw grep matches
- wire one code search server into several IDEs at once

## Example prompts
- Where is authorization configured in this repo? Use miru `search`.
- Use `find_related` to show what runs next to the payment handler.
- Give me full context around this line with `expand`.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md