MisakaNet MCP

MCP-сервер с общей памятью о сбоях: агент ищет проверенное решение ошибки раньше, чем начнет отлаживать ее с нуля

  • 565 ★ репозитория
  • Последний коммит
  • Apache-2.0
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Текст запроса с ошибкой уходит на внешний адрес misakanet.org, а в ошибках бывают пути, имена хостов и фрагменты секретов
  • Команды из найденного урока агент может выполнить без проверки
  • Установщик правит конфигурацию нескольких клиентов агентов
Все причины и проверки

ikalus1988/misakanet

Установка

Ручная установка

/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-серверШирокий доступ492Звезды репозитория
Выбор редакции

Официальный MCP-сервер GitHub: код, issues, пул-реквесты, Actions и алерты безопасности прямо из агента

MCP-серверШирокий доступ34,6 тыс.Звезды репозитория

Веб-раннер заданий на сервере с MCP-эндпоинтом: Claude Code запускает задания и воркфлоу, читает результаты и отвечает на заметки

MCP-серверШирокий доступ97Звезды репозитория
Выбор редакции

Официальный MCP-сервер Sentry: поиск ошибок, разбор событий и трейсов, анализ причин прямо из кодового агента

MCP-серверШирокий доступ970Звезды репозитория
Официальный

MCP-сервер Honeybadger: агент читает ошибки и аптайм-проверки, строит запросы Insights и правит дашборды и алармы

MCP-серверРасширенный доступ25Звезды репозитория
Официальный

Встроенный MCP OneUptime: агент разбирает инциденты, читает логи и трассы, подтверждает алерты и настраивает мониторы.

MCP-серверРасширенный доступ7,8 тыс.Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
MisakaNet (эта карточка)нетне нужна565
Episodic Memoryнет506память о ваших прошлых разговорах с агентом, без общей базы проверенных решений сбоев
Basic Memoryнетне нужна4 635личные заметки агента в Markdown с графом связей и семантическим поиском

Коротко о README

README начинается с мотивации и таблицы способов установки, затем показывает первый запрос к серверу через curl. Дальше идут ограничения проекта и приостановленный бенчмарк, правила участия и раздел про GitHub Action.

Бейдж для README

Сообщить о проблеме