How do I install Miru Code?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Miru Code need an API key?

The publisher lists these environment variables: TAKARA_API_KEY.

What transport does Miru Code use?

Miru Code runs locally over stdio.

When was Miru Code last checked?

Last checked 2026-11-10. Code search that lets AI coding agents find the right files in fewer steps. Use the hosted endpoint or self-host, works with Claude Code, Copilot and Cursor via MCP.

Máy chủ MCP Miru Code

Power your agent

Thêm server này

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Chạy trên PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @takara-ai/[email protected]

Credentials from the publisher

TAKARA_API_KEY — Takara API key. Optional: without it, the MCP auth tool signs in with a device code.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1TAKARA_API_KEY=<secret> claude mcp add takara-ai-miru-code -- npx -y @takara-ai/miru-code@1.10.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "takara-ai-miru-code": {4      "command": "npx",5      "args": [6        "-y",7        "@takara-ai/[email protected]"8      ],9      "env": {10        "TAKARA_API_KEY": "<secret>"11      }12    }13  }14}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Chạy trên PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Mở

Server facts

Local

Transport: stdio
License: MIT
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Miru (見る)

Hybrid code search for AI coding agents.

Ask where something happens in your codebase. Miru returns relevant file paths, line numbers, and source excerpts through MCP.

Install

Requires Bun 1.1 or later, with bunx on your PATH.

Claude Code (recommended)

Run inside Claude Code:

/plugin marketplace add takara-ai/miru-code
/plugin install miru@miru

Reload plugins or restart Claude Code, then ask:

Use Miru to find where authentication is configured in this project.

If credentials are missing, Claude can use Miru's auth tool to start sign-in. Approve the login code, then retry the search. Plugin credentials are separate from CLI credentials.

Other agents

See agent integrations for Codex and Cursor plugins. The Cursor plugin provides skills and rules; use the CLI installer below to connect its MCP tools.

Install (CLI fallback)

For terminal use or agents configured through the CLI:

bun add -g @takara-ai/miru-code
miru setup
miru install

Choose your agents in the installer, then restart them. See supported integrations. Use miru uninstall to remove the configuration.

Try it

miru search "auth middleware" ./src
miru locate REDIS_HOST ./src
miru expand src/auth.ts 42 ./src
miru find-related src/auth.ts 42 ./src

Use --json for scripts. Run miru <command> -h for options.

MCP tools

Tool	Purpose
`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

The optional repo argument defaults to the server's working directory. Miru builds the index on first use and watches local files for changes.

How it works

Miru combines embeddings, BM25, and code-aware ranking. Tree-sitter provides syntax-aware chunks for 26 languages, with structural and line-based fallbacks for other files.

See chunking and caching and the ranking evaluation.

Privacy and API usage

By default, Miru sends file contents as source chunks and search queries over HTTPS to Takara for embeddings. API usage may incur costs under your Takara plan.

For embeddings on your own infrastructure, use AWS SageMaker. Set MIRU_WORKSPACE_ROOT to restrict local MCP repository paths to one directory.

Documentation

Reference: CLI commands, MCP parameters, configuration, and benchmarks
Agent integrations: plugin capabilities, configuration paths, and optional skills
Contributing: development setup, checks, and releases

Credits

Miru builds on work by MinishLab:

semble: file walking, indexing, BM25, hybrid search, and ranking signals.
potion-code and Model2Vec: WordPiece tokenizer.

See NOTICE for attribution and licence text.

License

MIT