MisakaNet MCP
MCP-сервер с общей памятью о сбоях: агент ищет проверенное решение ошибки раньше, чем начнет отлаживать ее с нуля
- 565 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Текст запроса с ошибкой уходит на внешний адрес misakanet.org, а в ошибках бывают пути, имена хостов и фрагменты секретов
- Команды из найденного урока агент может выполнить без проверки
- Установщик правит конфигурацию нескольких клиентов агентов
Установка
- Работает в
Ручная установка
/plugin marketplace add Ikalus1988/MisakaNet
/plugin install misakanet@misakanetПодключает удаленные MCP-инструменты, установщик и локальный процесс не нужны.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Текст запроса с ошибкой уходит на внешний адрес misakanet.org, а в ошибках бывают пути, имена хостов и фрагменты секретов
- Команды из найденного урока агент может выполнить без проверки
- Установщик правит конфигурацию нескольких клиентов агентов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MisakaNet хранит уроки о сбоях как Markdown-файлы в репозитории. Урок описывает ошибку, причину и команды исправления, а уровень доказательности показывает, насколько он проверен. Темы — от Docker и CI до сетей, Windows и RAG. Каждый урок проходит ревью как код, и уровни E0–E3 ведут от заявки до воспроизведения и подтверждения в CI. Агент обращается к серверу через инструмент `misakanet_search` с текстом ошибки и получает урок, его уровень доказательности и путь к файлу. Поиск идет по словам алгоритмом BM25 на стандартной библиотеке Python, без векторной базы и модели эмбеддингов. Если совпадения нет, ответ содержит `no_match` и готовую заявку, которую агент отправляет вызовом `misakanet_submit_intake`: заявка превращается в задачу в репозитории, а после ревью в новый урок. Подключить сервер можно удаленным адресом, плагином для Claude Code, установщиком для десяти клиентов или пакетом для Python. Для репозиториев есть GitHub Action: при падении CI он ищет ближайший урок и пишет его в комментарий к pull request.
Для кого. Разработчикам и DevOps-инженерам, чьи агенты часто упираются в одни и те же ошибки окружения, сети, Docker и CI.
Подходит, если
- Агент снова бьется над ошибкой вроде таймаута `pip install` за корпоративным прокси или `database is locked`, и нужен уже проверенный ответ
- Вы работаете под Windows или в WSL и часто встречаете проблемы с кодировкой GBK и правами доступа
- Хочется, чтобы упавший CI сам оставлял в pull request комментарий с ближайшим решением из базы
- Агент должен сообщать базе о сбое, которого там еще нет, чтобы следующий агент его не повторил
- Нужен общий слой знаний о сбоях для нескольких клиентов: Claude Code, Codex, Cursor и других
Не подходит, если
- Нужна общая долговременная память агента о ваших проектах и разговорах: MisakaNet хранит только уроки о сбоях
- Нужен поиск по смыслу: BM25 сопоставляет слова, и ошибка, описанная другой лексикой, не найдется
- Ошибки содержат закрытые данные, которые нельзя отправлять на внешний сервер проекта
Пример запроса к агенту
Подключи MisakaNet и найди в нем решение для ошибки «database is locked», которую я получаю при запуске тестовMCP
- Транспорт
- http, stdio
- Авторизация
- не нужна
Ограничения
- Сервер знает только сбои, которые уже есть в базе. Пробел в корпусе не закрывает никакая настройка поиска.
- Уроки пишет сообщество. Перед запуском команд из урока прочитайте файл целиком, а агента держите в песочнице.
- Сопровождающие разбирают очередь заявок медленнее, чем приходят новые сбои.
- Автор приостановил бенчмарк: он измерял, насколько точно модель воспроизводит выданный ей урок, и качество поиска не доказывает.
- Установщику нужен Node 18 или новее, библиотеке и локальному stdio-серверу — Python 3.10 или новее.
Как отключить. Установщик, запущенный с флагом --uninstall, убирает записи MisakaNet из настроек клиентов. Плагин Claude Code снимается командой /plugin uninstall misakanet@misakanet, а адрес https://misakanet.org/mcp можно просто удалить из конфигурации MCP.
Частые вопросы
Как подключить MisakaNet к Claude Code?
Выполните /plugin marketplace add Ikalus1988/MisakaNet, затем /plugin install misakanet@misakanet. Плагин подключает удаленный MCP-сервер, локальный процесс и установщик не нужны. Для остальных клиентов есть команда npx @misaka-net/misakanet-setup, которая прописывает сервер в их конфигурации.
Что вернет MisakaNet, если такой ошибки в базе нет?
Ответ `no_match` и готовая заявка. Агент отправляет ее вызовом `misakanet_submit_intake`, аккаунт, почта и токен для этого не нужны, хватает отчета из пяти строк. Заявка становится задачей в репозитории и может превратиться в урок.
Как понять, можно ли доверять найденному уроку?
Смотрите поле `evidence_level`: E0 означает заявку, E1 урок после ревью, E2 воспроизведенный сбой, E3 подтверждение в CI. Уровень E4, повторное использование двумя разными клиентами, никто не может присвоить голосованием, и сейчас в базе его нет.
Чем MisakaNet отличается от обычной памяти агента?
Это общая база знаний о сбоях: уроки лежат в репозитории как Markdown-файлы с ревью и уровнем доказательности и доступны всем клиентам. Хранение разговоров и личных заметок в задачи проекта не входит.
Нужна ли регистрация, чтобы искать решения?
Нет. Чтение анонимное и без лимитов, регистрация нужна только для записи, а заявку о сбое можно отправить и без нее. Клиенту с MCP по HTTP достаточно удаленного адреса сервера.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыАгент управляет серверами через каталог объявленных действий: политика решает, что выполнить, а что ждет человека
Официальный MCP-сервер GitHub: код, issues, пул-реквесты, Actions и алерты безопасности прямо из агента
Веб-раннер заданий на сервере с MCP-эндпоинтом: Claude Code запускает задания и воркфлоу, читает результаты и отвечает на заметки
Официальный MCP-сервер Sentry: поиск ошибок, разбор событий и трейсов, анализ причин прямо из кодового агента
MCP-сервер Honeybadger: агент читает ошибки и аптайм-проверки, строит запросы Insights и правит дашборды и алармы
Встроенный MCP OneUptime: агент разбирает инциденты, читает логи и трассы, подтверждает алерты и настраивает мониторы.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MisakaNet (эта карточка) | нет | не нужна | 565 | |
| Episodic Memory | нет | 506 | память о ваших прошлых разговорах с агентом, без общей базы проверенных решений сбоев | |
| Basic Memory | нет | не нужна | 4 635 | личные заметки агента в Markdown с графом связей и семантическим поиском |
Коротко о README
README начинается с мотивации и таблицы способов установки, затем показывает первый запрос к серверу через curl. Дальше идут ограничения проекта и приостановленный бенчмарк, правила участия и раздел про GitHub Action.