Skip to content
MCP server

Miru

Hybrid semantic and keyword code search that gives coding agents file paths and snippets

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
1.10.1
Listing updated
1 day ago

About Miru

Miru is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Miru answers questions like where authentication is configured by returning ranked file paths, line numbers and source excerpts instead of making the agent read whole files. The pitch from its maker, Takara, is fewer tokens spent on search.

Under the hood it combines embeddings, BM25 and code-aware ranking, chunking source with Tree-sitter for 26 languages and falling back to structural or line-based chunks for others. It builds its index on first use and watches local files for changes. The README credits MinishLab's semble and potion-code work as foundations.

By default it sends file chunks and queries over HTTPS to Takara for embeddings, which can incur costs under a Takara plan, and an API key is optional because an auth tool can sign in with a device code. For embeddings on your own infrastructure it can use an AWS SageMaker endpoint, and an environment variable restricts which repository paths the server may reach. It needs Bun 1.1 or later.

Install

Run in a terminal

claude mcp add miru --env TAKARA_API_KEY='<TAKARA_API_KEY>' -- npx -y @takara-ai/miru-code

Add to claude_desktop_config.json

{
  "mcpServers": {
    "miru": {
      "command": "npx",
      "args": [
        "-y",
        "@takara-ai/miru-code"
      ],
      "env": {
        "TAKARA_API_KEY": "<TAKARA_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "miru": {
      "command": "npx",
      "args": [
        "-y",
        "@takara-ai/miru-code"
      ],
      "env": {
        "TAKARA_API_KEY": "<TAKARA_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "miru": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@takara-ai/miru-code"
      ],
      "env": {
        "TAKARA_API_KEY": "<TAKARA_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "miru": {
      "command": "npx",
      "args": [
        "-y",
        "@takara-ai/miru-code"
      ],
      "env": {
        "TAKARA_API_KEY": "<TAKARA_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "miru": {
      "command": "npx",
      "args": [
        "-y",
        "@takara-ai/miru-code"
      ],
      "env": {
        "TAKARA_API_KEY": "<TAKARA_API_KEY>"
      }
    }
  }
}

Configuration

  • TAKARA_API_KEYTakara API key. Optional: without it, the MCP auth tool signs in with a device code.

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

search
Find code by meaning
locate
Find exact strings, regex matches or filenames
expand
Read neighbouring chunks in the same file
find_related
Find similar code in other files
auth
Sign in or configure a SageMaker endpoint
read_benchmark
Read token-savings totals when benchmark mode is enabled

What it does

Meaning-based search
Find code by what it does, not only by exact words.
Exact lookup
Locate strings, regex matches or filenames.
Context expansion
Read neighbouring chunks around a hit.
Related code
Find similar code in other files.
Language-aware chunking
Tree-sitter chunking for 26 languages.
Self-hosted embeddings
Use an AWS SageMaker endpoint instead of Takara's API.

Good for

  • Find where a feature is implemented in an unfamiliar repo
  • Track down where an environment variable is read
  • Cut the tokens an agent spends exploring code
  • Find duplicate or similar logic across files

Pricing

Open source

MIT licence; Takara API usage may incur costs under a Takara plan

Prices change. Check takara.ai before you buy.

Miru FAQ

What does it send off my machine?

By default file chunks and queries go to Takara over HTTPS for embeddings.

Can I keep embeddings private?

Yes, via a self-hosted AWS SageMaker endpoint.

What do I need to install?

Bun 1.1 or later, then a Claude Code plugin or the CLI installer.

What licence is it?

MIT.

Is Miru free?

Yes. Miru is open source, so you can use and self-host it for free.

How do I add Miru to Claude Code?

Run this command in your terminal: claude mcp add miru --env TAKARA_API_KEY='<TAKARA_API_KEY>' -- npx -y @takara-ai/miru-code

What are the best alternatives to Miru?

The closest alternatives to Miru are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Miru

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools