fabricator-panel-mcp — MCP-сервер для Claude Code: диагностика
Подключает ИИ-клиент к панели Fabricator по HTTP API и помогает разобраться, почему падает сервер с модпаком.
claude mcp add --env FABRICATOR_URL=<FABRICATOR_URL> --env FABRICATOR_TOKEN=<FABRICATOR_TOKEN> --transport stdio mcp -- uvx fabricator-panel-mcpЧто делает fabricator-panel-mcp
Сервер запускается на вашей машине рядом с MCP-клиентом и общается с панелью Fabricator через её HTTP API. Токен вы создаёте в разделе «Settings» → «Model Context Protocol». Дальше ассистент читает лог, смотрит, какие моды стоят, проверяет мод на Modrinth, убирает или обновляет его и перезапускает сервер.
Что именно доступно, решает область токена, и проверяет это сама панель. С read можно смотреть список серверов, вывод консоли и логи падений, установленные моды и совместимые обновления, расход CPU и памяти, диагностику Java и установки, покрытие бэкапов и метаданные снимков. С manage добавляются запуск, остановка и перезапуск, установка сервера по сохранённой конфигурации, установка или обновление одного мода по id проекта Modrinth и удаление jar-файлов. Для диагностики хватает read — он ничего не меняет.
Нужен установленный uv в PATH: без него клиент сообщит, что сервер не стартует или отваливается при запуске, и это будет похоже на проблему с панелью или токеном, хотя процесс просто не поднимается. Токен лежит открытым текстом в конфиге клиента, не истекает и читается только из переменных окружения, не из аргументов командной строки. Моды, лежащие во вложенных папках внутри mods, в списке не видны и через remove_mods не удаляются.
Какие задачи решает
- понять, из-за чего падает сервер с модпаком
- прочитать лог падения и вывод консоли
- проверить установленный мод на совместимость с Modrinth
- обновить один мод по id проекта
- посмотреть расход CPU и памяти сервера
Примеры запросов агенту
- Посмотри лог последнего падения сервера и скажи, какой мод его роняет
- Проверь установленные моды на совместимые обновления в Modrinth
- Перезапусти сервер и покажи, что пишет консоль при старте
Как установить fabricator-panel-mcp
Командой платформы
claude mcp add --env FABRICATOR_URL=<FABRICATOR_URL> --env FABRICATOR_TOKEN=<FABRICATOR_TOKEN> --transport stdio mcp -- uvx fabricator-panel-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fabricator-panel-mcp <команда>
Командой платформы
codex mcp add mcp --env FABRICATOR_URL=<FABRICATOR_URL> --env FABRICATOR_TOKEN=<FABRICATOR_TOKEN> -- uvx fabricator-panel-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fabricator-panel-mcp <команда>
Файл настроек
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"fabricator-panel-mcp"
],
"env": {
"FABRICATOR_URL": "<FABRICATOR_URL>",
"FABRICATOR_TOKEN": "<FABRICATOR_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fabricator-panel-mcp <команда>
Файл настроек
{
"servers": {
"mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"fabricator-panel-mcp"
],
"env": {
"FABRICATOR_URL": "<FABRICATOR_URL>",
"FABRICATOR_TOKEN": "<FABRICATOR_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fabricator-panel-mcp <команда>
Командой платформы
gemini mcp add -e FABRICATOR_URL=<FABRICATOR_URL> -e FABRICATOR_TOKEN=<FABRICATOR_TOKEN> mcp uvx fabricator-panel-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fabricator-panel-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о fabricator-panel-mcp
Как установить fabricator-panel-mcp в Claude Code?
Выполните claude mcp add fabricator-panel-mcp -e FABRICATOR_TOKEN=<FABRICATOR_TOKEN> -- uvx fabricator-panel-mcp. Если панель не на http://127.0.0.1:5000, добавьте адрес: claude mcp add --env FABRICATOR_URL=<FABRICATOR_URL> --env FABRICATOR_TOKEN=<FABRICATOR_TOKEN> --transport stdio mcp -- uvx fabricator-panel-mcp.
Что делает fabricator-panel-mcp?
Даёт ассистенту доступ к панели Fabricator: список серверов, логи и консоль, установленные моды, проверка обновлений через Modrinth, а с токеном manage ещё запуск, перезапуск и правка модов.
Что нужно для работы сервера?
Панель, доступная с этой машины, с включённым MCP-доступом, API-токен из её настроек и uv в PATH. Без uv клиент покажет, что сервер не запускается.
