miru — MCP-сервер поиска по коду
Гибридный поиск по коду для ИИ-агентов: находит нужные фрагменты по смыслу, а не только по совпадению строк, и отдаёт агенту путь, строки и сниппет.
claude mcp add miru -e TAKARA_API_KEY=<TAKARA_API_KEY> -- npx -y @takara-ai/miru-codeЧто делает miru
miru ставит в агент четыре инструмента: search, locate, expand и find_related. Агент спрашивает что-то вроде «где настраивается middleware для аутентификации», а сервер возвращает подходящие куски кода. Вместо grep и glob агент получает готовый контекст.
Установка идёт через CLI: глобальный пакет @takara-ai/miru-code на Bun или npx, затем miru setup для входа по device-code и miru install, где в интерактивном меню выбираются MCP-сервер, файл инструкций для CLAUDE.md / AGENTS.md, субагент и правила для Cursor. Через маркетплейс плагинов тоже можно, но набор возможностей там уже: в Cursor плагин приносит только скиллы и правила, без MCP.
Ключ TAKARA_API_KEY нужен в обоих случаях, и учётные данные плагина хранятся отдельно от CLI, поэтому при обеих установках войти придётся дважды. Без ключа сервер не поднимется.
Какие задачи решает
- найти место настройки middleware, когда не помнишь имя файла
- достать связанные с правкой участки кода, не читая весь модуль
- дать агенту контекст по смыслу запроса вместо перебора grep
- подключить поиск по коду сразу в несколько IDE через один сервер
Примеры запросов агенту
- Где у нас настраивается авторизация? Используй
searchиз miru. - Найди через
find_relatedкод, который вызывается рядом с обработчиком платежей. - Покажи через
expandполный контекст вокруг этой строки.
Как установить miru
Командой платформы
claude mcp add miru -e TAKARA_API_KEY=<TAKARA_API_KEY> -- npx -y @takara-ai/miru-codeВместо <…> подставьте свои значения
Командой платформы
codex mcp add miru --env TAKARA_API_KEY=<TAKARA_API_KEY> -- npx -y @takara-ai/miru-codeВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"miru": {
"command": "npx",
"args": [
"-y",
"@takara-ai/miru-code"
],
"env": {
"TAKARA_API_KEY": "<TAKARA_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"miru": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@takara-ai/miru-code"
],
"env": {
"TAKARA_API_KEY": "<TAKARA_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e TAKARA_API_KEY=<TAKARA_API_KEY> miru npx -y @takara-ai/miru-codeВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о miru
Как установить miru в Claude Code?
Два пути. Через CLI: bun add -g @takara-ai/miru-code, затем miru setup и miru install. Через маркетплейс плагинов: /plugin marketplace add takara-ai/miru-code, потом /plugin install miru.
Зачем нужен miru?
Чтобы агент искал код по смыслу запроса, а не перебирал строки через grep. На выходе он получает путь, строки и сниппет подходящего фрагмента.
Нужен ли ключ API?
Да, сервер запускается с TAKARA_API_KEY. Токен сохраняется через miru setup или напрямую через miru setup --key YOUR_TOKEN.
