Miru
Hybrid semantic and keyword code search that gives coding agents file paths and snippets
- 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-codeAdd 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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools