Mantic.sh
MCP сервер структурного поиска по коду для агентов: находит нужный файл по смыслу запроса и работает локально
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Читает и индексирует ваш код локально при поиске
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mantic-shОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio mantic -- npx -y mantic.sh@latest serverИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"mantic": {
"command": "npx",
"args": [
"-y",
"mantic.sh@latest",
"server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"mantic": {
"command": "npx",
"args": [
"-y",
"mantic.sh@latest",
"server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"mantic","type":"stdio","command":"npx","args":["-y","mantic.sh@latest","server"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"mantic": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mantic.sh@latest",
"server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Выполните в терминале
codex mcp add mantic -- npx -y mantic.sh@latest serverИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.mantic]
command = "npx"
args = ["-y", "mantic.sh@latest", "server"]Если файл уже есть, допишите блок в конец.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"mantic": {
"command": "npx",
"args": [
"-y",
"mantic.sh@latest",
"server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"mantic": {
"command": "npx",
"args": [
"-y",
"mantic.sh@latest",
"server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"mantic": {
"command": "npx",
"args": [
"-y",
"mantic.sh@latest",
"server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"mantic": {
"command": "npx",
"args": [
"-y",
"mantic.sh@latest",
"server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"mantic": {
"type": "local",
"command": [
"npx",
"-y",
"mantic.sh@latest",
"server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"mantic": {
"command": "npx",
"args": [
"-y",
"mantic.sh@latest",
"server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"mantic": {
"command": "npx",
"args": [
"-y",
"mantic.sh@latest",
"server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавь в конфигурацию MCP сервер mantic с командой npx и аргументами -y, mantic.sh@latest, server. Ключи не нужны, все работает локально.
Другие способы из описания автора
npx -y mantic.sh@latest serverЗапуск MCP сервера по stdio. Для CLI используйте npx mantic.sh с запросом.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Mantic это движок поиска по коду, который делает ставку на релевантность выдачи, а не на голую скорость. Он выводит намерение из структуры проекта и метаданных, отфильтровывая лишние файлы до чтения содержимого, за счет этого меньше токенов уходит на нерелевантное. Есть переход к определению и поиск всех использований символа по монорепозиторию с учетом gitignore. Опциональное семантическое переранжирование на локальных эмбеддингах находит близкий по смыслу код без точного совпадения слов. Работает как CLI и как MCP сервер для агентов, все локально и без выгрузки данных наружу.
Для кого. Для разработчиков, которым нужен точный поиск по большому коду прямо из агента без выгрузки в облако.
Подходит, если
- Нужно найти в проекте файл по смыслу запроса, а не по точным словам
- Нужен переход к определению или все использования символа по монорепо
- Хотите сократить токены на нерелевантные файлы при поиске
Не подходит, если
- Нужна максимальная скорость на очень большом репозитории, а не ранжирование
- Достаточно обычного grep по точному совпадению строки
Пример запроса к агенту
Найди в проекте, где реализована обработка оплаты, покажи точный файлОграничения
На очень больших репозиториях по чистой скорости уступает grep и ripgrep, ставка сделана на качество выдачи. Семантическое переранжирование включается флагом и подтягивает локальные эмбеддинги. Заявленные бенчмарки и цифры экономии измерял автор, проверьте их на своем коде.
Как отключить. Удалите блок mantic из конфигурации MCP клиента. Установленный глобально пакет уберите средствами пакетного менеджера.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Проверка безопасности
- Читает и индексирует ваш код локально при поиске
Коротко о README
README описывает Mantic как движок структурного поиска по коду для агентов, который ставит релевантность выше чистой скорости. Он выводит намерение из структуры и метаданных, отсекает лишние файлы до чтения и так экономит токены, а также умеет переход к определению и поиск использований по монорепо. Есть опциональное семантическое переранжирование на локальных эмбеддингах и разбор кода через Tree-sitter. Все работает локально без выгрузки данных, ставится как CLI или подключается как MCP сервер по stdio через npx. Лицензия MIT.
Частые вопросы
Данные уходят в облако?
Нет, поиск работает полностью локально без выгрузки данных наружу, включая опциональные локальные эмбеддинги.
Это только MCP сервер?
Нет, есть и CLI, и MCP сервер, плюс расширение для редактора, режим сервера запускается аргументом server.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything