rag-mcp — MCP-сервер для Claude Code: поиск по файлам
MCP-сервер rag-mcp для Claude Code ищет сведения в выбранных файлах и папках. Агент получает фрагменты по смыслу или точным словам и может составить ответ с опорой на найденное.
MIT ★ 9 обновлён 2026-11-15
claude mcp add rag-mcp -e OPENROUTER_API_KEY=<OPENROUTER_API_KEY> -- uvx ragmcp-cliЧто делает rag-mcp
rag-mcp ищет по локальным файлам и папкам, ограниченным заданной областью, и возвращает подходящие фрагменты для ответа на вопрос. Точный поиск работает через BM25; смысловой поиск использует эмбеддинги, а результаты может ранжировать отдельная модель. MCP-сервер также умеет создавать ответы на основе найденных материалов.
Базовый поиск запускается без аккаунта и API-ключа. Для смыслового поиска нужно выбрать провайдера эмбеддингов; для письменных ответов можно войти в Codex с планом ChatGPT или задать ключ OpenRouter. Если задан OPENROUTER_API_KEY, OpenRouter также получает запрос и найденные фрагменты для ранжирования; эта функция включена автоматически. Исходные файлы и индекс остаются локально.
Какие задачи решает
- найти нужные фрагменты в выбранной папке
- искать по смыслу, даже если вопрос использует другие слова
- составить ответ по содержимому локальных документов
Примеры запросов агенту
- Найди в
./docsматериалы о лимитах загрузки и ответь по ним. - Поищи в папке
./docsдокументы о том, как изменились требования. - Найди в
./docsсведения о сроке хранения файлов после закрытия аккаунта.
Как установить rag-mcp
Командой платформы
claude mcp add rag-mcp -e OPENROUTER_API_KEY=<OPENROUTER_API_KEY> -- uvx ragmcp-cliВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from ragmcp-cli <команда>
Командой платформы
codex mcp add rag-mcp --env OPENROUTER_API_KEY=<OPENROUTER_API_KEY> -- uvx ragmcp-cliВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from ragmcp-cli <команда>
Файл настроек
{
"mcpServers": {
"rag-mcp": {
"command": "uvx",
"args": [
"ragmcp-cli"
],
"env": {
"OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from ragmcp-cli <команда>
Файл настроек
{
"servers": {
"rag-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"ragmcp-cli"
],
"env": {
"OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from ragmcp-cli <команда>
Командой платформы
gemini mcp add -e OPENROUTER_API_KEY=<OPENROUTER_API_KEY> rag-mcp uvx ragmcp-cliВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from ragmcp-cli <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о rag-mcp
Как установить rag-mcp в Claude Code?
Выполни claude mcp add rag-mcp -e OPENROUTER_API_KEY=<OPENROUTER_API_KEY> -- uvx ragmcp-cli. Команда добавит сервер MCP с ключом OpenRouter.
Что делает rag-mcp?
Ищет информацию в заданных локальных файлах и папках: по словам или по смыслу. Найденные фрагменты можно использовать для ответа на вопрос.
Что нужно для работы rag-mcp?
Точный поиск работает без аккаунта и ключа. Смысловой поиск требует выбранного провайдера эмбеддингов; для ответов можно использовать Codex с входом через codex login и планом ChatGPT либо ключ OpenRouter.