Каталог MCP
HadiCherkaoui/crafty-mcp

HadiCherkaoui/crafty-mcp

Name: HadiCherkaoui/crafty-mcp
Availability: InStock
Author: hadicherkaoui

MCP сервер для Crafty Controller 4, открывающий полный API управления Minecraft-серверами через AI-ассистентов. Запускай и останавливай серверы, отправляй консольные команды, управляй игроками, фай...

Github NPM Сайт сервера

README

63 инструмента

Версии

Установить сервер

crafty-mcp

npm

An MCP (Model Context Protocol) server for Crafty Controller 4 — manage your Minecraft servers via AI assistants.

The first MCP server for Crafty Controller.

What it does

crafty-mcp exposes the full Crafty Controller 4 API V2 as MCP tools, letting AI assistants like Claude manage your Minecraft servers using natural language. Start and stop servers, send console commands, manage players, edit server files, configure backups, set up scheduled tasks, manage webhooks, and administer users — all without leaving your AI chat.

Quick Start

Add to your MCP client config:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "crafty": {
      "command": "npx",
      "args": ["-y", "crafty-mcp"],
      "env": {
        "CRAFTY_URL": "https://localhost:8443",
        "CRAFTY_API_TOKEN": "your-bearer-token",
        "CRAFTY_ALLOW_INSECURE": "true"
      }
    }
  }
}

Инструменты были проиндексированы: 15.10.2026

crafty_api_info

Получить информацию о версии API Crafty Controller и сообщение дня (MOTD). Не требует аутентификации.

Параметры

Без параметров.

crafty_get_config

Получить настройки конфигурации панели Crafty Controller

Параметры

Без параметров.

crafty_get_schema

Получить конкретную JSON-схему по имени из Crafty Controller. Используйте crafty_list_schemas, чтобы узнать доступные имена схем.

Параметры

schema_namestringобязательный
Имя схемы (используйте crafty_list_schemas, чтобы увидеть доступные имена)

crafty_get_stats

Получить статистику хост-системы Crafty Controller: использование/количество/частота ЦП, использование/общий объем/процент ОЗУ, данные диска (устройство, всего, использовано, свободно, процент, файловая система, точка монтирования) и время загрузки

Параметры

Без параметров.

crafty_list_schemas

Вывести список всех доступных имён JSON-схем в Crafty Controller. Не требует аутентификации.

Параметры

Без параметров.

crafty_login

Выполните вход с помощью имени пользователя и пароля, чтобы получить bearer token. Используйте этот способ, если вы предпочитаете аутентификацию по имени пользователя/паролю, а не по предварительно сгенерированному API token.

Параметры

passwordstringобязательный
Пароль Crafty Controller
totpstring
Код TOTP/2FA (обязателен, если на аккаунте включена MFA)
usernamestringобязательный
Имя пользователя Crafty Controller

crafty_update_config

Обновляет настройки конфигурации панели Crafty Controller.

Параметры

configobjectобязательный
Пары «ключ-значение» конфигурации для обновления

role_create

Создать новую роль в Crafty Controller

Параметры

role_dataobjectобязательный
Данные конфигурации роли.

role_delete

Удалить роль из Crafty Controller

Параметры

role_idstringобязательный
Идентификатор роли для удаления.

role_get

Получить подробности о конкретной роли

Параметры

role_idstringобязательный
Идентификатор роли

role_list

Вывести список всех ролей в Crafty Controller

Параметры

Без параметров.

role_update

Обновить существующую роль в Crafty Controller

Параметры

role_idstringобязательный
Role ID для обновления
updatesobjectобязательный
Поля роли для обновления

server_backup

Запустить немедленное резервное копирование файлов сервера Minecraft.

Параметры

server_idstringобязательный
ID сервера или UUID

server_clone

Клонировать существующий сервер Minecraft (сервер не должен быть запущен)

Параметры

server_idstringобязательный
ID сервера или UUID

server_create

Создайте новый сервер Minecraft в Crafty Controller. Поддерживаются Java (скачать jar или импорт), Bedrock и пользовательские типы серверов.

Параметры

create_typeenumобязательный
Тип создания сервера
minecraft_bedrock_create_dataobject
Обязательно, когда create_type имеет значение minecraft_bedrock.
minecraft_java_create_dataobject
Обязательно, когда create_type имеет значение minecraft_java.
monitoring_typeenumобязательный
Мониторинг/тип сервера
namestringобязательный
Имя сервера (мин. 2 символа, без слэшей и решёток)

server_create_directory

Создаёт новый каталог на сервере Minecraft.

Параметры

namestringобязательный
Новое имя каталога
parentstringобязательный
Путь к родительскому каталогу.
server_idstringобязательный
ID сервера или UUID

server_create_file

Создать новый файл на сервере Minecraft

Параметры

namestringобязательный
Новое имя файла
parentstringобязательный
Путь к родительскому каталогу.
server_idstringобязательный
ID сервера или UUID

server_create_task

Создайте запланированную задачу для сервера Minecraft. Используйте interval_type с interval для простых расписаний (например, каждые 6 часов) или задайте cron_string с пустым interval_type для расписаний на основе cron (например, '0 3 * * *' для ежедневного запуска в 3 часа ночи).

Параметры

actionstringобязательный
Тип действия: команда, резервное копирование, перезапуск, запуск, остановка
action_idstring
Идентификатор цели действия, если применимо
commandstring
Команда для запуска (для типа действия command)
cron_stringstring
Cron-выражение (например, '0 3 * * *'). Используйте с interval_type=''.
delaynumber
Задержка в секундах перед запуском
enabledboolean
Активна ли задача.
intervalnumber
Номер интервала (используется с interval_type)
interval_typeenum
Единица интервала. Используйте пустую строку с cron_string для cron-расписаний.
namestringобязательный
Имя задачи
one_timeboolean
Запусти один раз, потом удали.
server_idstringобязательный
ID сервера или UUID
start_timestring
Время начала в формате HH:MM

server_create_webhook

Создать новый вебхук для сервера Minecraft. Поддерживает Discord и другие типы вебхуков. События-триггеры: server_start, server_stop, server_backup, player_join, player_leave и т.д.

Параметры

bodystring
Пользовательский шаблон тела вебхука
bot_namestring
Отображаемое имя бота
enabledboolean
Активен ли вебхук
namestringобязательный
Имя вебхука
server_idstringобязательный
ID сервера или UUID
triggerstringобязательный
Триггерное событие: server_start, server_stop, server_backup, player_join, player_leave и т. д.
urlstringобязательный
URL вебхука.
webhook_typestringобязательный
Тип вебхука, например 'Discord'

server_decompress_file

Декомпрессирует/распаковывает архивный файл на сервере Minecraft

Параметры

folderstringобязательный
Относительный путь к файлу архива для распаковки
server_idstringобязательный
ID сервера или UUID

server_delete

Удалить сервер Minecraft из Crafty Controller

Параметры

server_idstringобязательный
ID сервера или UUID

server_delete_backup

Удалить конкретную резервную копию для сервера Minecraft

Параметры

backup_idstringобязательный
Идентификатор резервной копии для удаления
server_idstringобязательный
ID сервера или UUID

server_delete_file

Удалить один или несколько файлов или каталогов с сервера Minecraft.

Параметры

pathsstring[]обязательный
Массив относительных путей к файлам для удаления
server_idstringобязательный
ID сервера или UUID

server_delete_task

Удаляет запланированную задачу с сервера Minecraft

Параметры

server_idstringобязательный
ID сервера или UUID
task_idstringобязательный
ID задачи для удаления

server_delete_webhook

Удалить вебхук с сервера Minecraft

Параметры

server_idstringобязательный
ID сервера или UUID
webhook_idstringобязательный
Идентификатор вебхука для удаления

server_get

Получить полные сведения о конфигурации для конкретного сервера Minecraft

Параметры

server_idstringобязательный
ID сервера или UUID

server_get_backup_config

Получить конфигурацию резервного копирования для сервера Minecraft (сжатие, исключения, расписание, максимальное количество резервных копий)

Параметры

server_idstringобязательный
ID сервера или UUID

server_get_file

Читает содержимое файла на сервере Minecraft (например, server.properties, ops.json, whitelist.json)

Параметры

pathstringобязательный
Относительный путь к файлу для чтения.
server_idstringобязательный
ID сервера или UUID

server_get_history

Получить историческую статистику времени выполнения для сервера Minecraft (загрузка CPU, RAM в динамике, полезно для построения графиков трендов)

Параметры

server_idstringобязательный
ID сервера или UUID

server_get_logs

Получить консольные логи сервера Minecraft в виде массива строк логов

Параметры

server_idstringобязательный
ID сервера или UUID

server_get_stats

Получить живую статистику времени выполнения для сервера Minecraft, включая использование ЦП/ОЗУ, количество онлайн-игроков и список, имя/размер мира, MOTD, версию и работает ли он.

Параметры

server_idstringобязательный
ID сервера или UUID

server_get_task

Получить конфигурацию для конкретной запланированной задачи

Параметры

server_idstringобязательный
ID сервера или UUID
task_idstringобязательный
Идентификатор задачи

server_get_webhook

Получить подробности о конкретном вебхуке.

Параметры

server_idstringобязательный
ID сервера или UUID
webhook_idstringобязательный
Идентификатор вебхука

server_kill

Принудительно завершить процесс сервера Minecraft немедленно

Параметры

server_idstringобязательный
ID сервера или UUID

server_list

Выведи список всех серверов Minecraft, управляемых Crafty Controller, с их ID, именами, типами, портами и конфигурациями.

Параметры

Без параметров.

server_list_backups

Вывести список всех резервных копий сервера Minecraft с временными метками и размерами

Параметры

server_idstringобязательный
ID сервера или UUID

server_list_files

Перечислить файлы и каталоги в директории сервера Minecraft

Параметры

pathstring
Относительный путь для получения списка (пустая строка - корень)
server_idstringобязательный
ID сервера или UUID

server_list_tasks

Выведи список всех запланированных задач для сервера Minecraft

Параметры

server_idstringобязательный
ID сервера или UUID

server_list_webhooks

Перечислить все вебхуки, настроенные для сервера Minecraft

Параметры

server_idstringобязательный
ID сервера или UUID

server_rename_file

Переименовать или переместить файл или каталог на сервере Minecraft.

Параметры

new_namestringобязательный
Имя нового файла/каталога
pathstringобязательный
Текущий относительный путь к файлу
server_idstringобязательный
ID сервера или UUID

server_restart

Перезапустить сервер Minecraft

Параметры

server_idstringобязательный
ID сервера или UUID

server_restore_backup

Восстановить конкретную резервную копию для сервера Minecraft

Параметры

backup_idstringобязательный
Идентификатор резервной копии
filenamestringобязательный
Имя файла резервной копии для восстановления.
in_placeboolean
Восстанавливает на месте (true) или в новое расположение
server_idstringобязательный
ID сервера или UUID

server_run_task

Вручную запустить запланированную задачу немедленно

Параметры

server_idstringобязательный
ID сервера или UUID
task_idstringобязательный
ID задачи для запуска

server_send_command

Отправляет команду в консоль запущенного сервера Minecraft. Примеры: 'say Hello everyone!', 'op PlayerName', 'whitelist add Player', 'gamemode creative Player', 'time set day', 'weather clear'

Параметры

commandstringобязательный
Команда для отправки в консоль сервера (без ведущего слеша)
server_idstringобязательный
ID сервера или UUID

server_start

Запускает сервер Minecraft.

Параметры

server_idstringобязательный
ID сервера или UUID

server_stop

Останавливает сервер Minecraft (отправляет настроенную команду остановки)

Параметры

server_idstringобязательный
ID сервера или UUID

server_test_webhook

Отправляет тестовое сообщение для проверки работоспособности вебхука.

Параметры

server_idstringобязательный
ID сервера или UUID
webhook_idstringобязательный
Идентификатор вебхука для тестирования.

server_update

Изменить конфигурацию сервера Minecraft (название, порты, автозапуск, обнаружение сбоев, команда остановки и т.д.)

Параметры

server_idstringобязательный
ID сервера или UUID
updatesobjectобязательный
Поля конфигурации для обновления

server_update_backup_config

Обновить конфигурацию резервного копирования для сервера Minecraft.

Параметры

afterstring
Команда для запуска после резервного копирования.
backup_namestring
Имя конфигурации резервного копирования
beforestring
Команда для выполнения перед резервным копированием
compressboolean
Сжимает резервные копии.
excluded_dirsstring[]
Каталоги, которые нужно исключить из резервного копирования.
max_backupsnumber
Максимальное количество резервных копий для хранения.
server_idstringобязательный
ID сервера или UUID
shutdownboolean
Остановите сервер перед созданием резервной копии.

server_update_executable

Обновляет серверный jar/исполняемый файл из настроенного URL загрузки.

Параметры

server_idstringобязательный
ID сервера или UUID

server_update_file

Записать или обновить файл на сервере Minecraft (например, server.properties, ops.json, whitelist.json)

Параметры

contentsstringобязательный
Новое содержимое файла.
overwriteboolean
Перезаписывать, даже если файл изменён внешне
pathstringобязательный
Относительный путь к файлу
server_idstringобязательный
ID сервера или UUID

server_update_task

Обновить существующую запланированную задачу для сервера Minecraft

Параметры

server_idstringобязательный
ID сервера или UUID
task_idstringобязательный
ID задачи для обновления
updatesobjectобязательный
Поля задачи для обновления

server_update_webhook

Обновить существующий вебхук для сервера Minecraft

Параметры

server_idstringобязательный
ID сервера или UUID
updatesobjectобязательный
Поля Webhook для обновления
webhook_idstringобязательный
ID вебхука для обновления

user_create

Создать новую учётную запись пользователя Crafty Controller. Требуются привилегии суперпользователя.

Параметры

emailstring
адрес электронной почты
langstring
Код языка (например, 'en', 'fr', 'de')
managernumber
ID менеджера (назначает менеджера для этого пользователя)
passwordstringобязательный
Пароль
superuserboolean
Предоставляет привилегии суперпользователя.
themestring
UI тема
usernamestringобязательный
Имя пользователя

user_create_api_key

Создать новый API-ключ для пользователя Crafty Controller

Параметры

namestring
Необязательное имя/описание для ключа API.
user_idstringобязательный
Идентификатор пользователя или «@me»

user_delete

Навсегда удаляет учетную запись пользователя Crafty Controller. Требуются привилегии суперпользователя.

Параметры

user_idstringобязательный
Идентификатор пользователя для удаления

user_delete_api_key

Отозвать/удалить API-ключ для пользователя Crafty Controller

Параметры

key_idstringобязательный
ID ключа API для отзыва
user_idstringобязательный
Идентификатор пользователя или «@me»

user_get

Получить данные конкретного пользователя Crafty Controller. Используйте '@me' в качестве user_id, чтобы получить текущего аутентифицированного пользователя.

Параметры

user_idstringобязательный
ID пользователя или '@me' для текущего пользователя

user_get_api_keys

Вывести список API-ключей для пользователя Crafty Controller

Параметры

user_idstringобязательный
Идентификатор пользователя или «@me»

user_get_permissions

Получить разрешения пользователя в Crafty и на каждом сервере

Параметры

user_idstringобязательный
Идентификатор пользователя или «@me»

user_list

Выводит всех пользователей Crafty Controller. Возвращает user_id, username, enabled, superuser, lang и дату создания.

Параметры

ids_onlyboolean
Если true, возвращает только идентификаторы пользователей для минимального ответа.

user_update

Обновить учётную запись пользователя Crafty Controller

Параметры

updatesobjectобязательный
Поля пользователя для обновления
user_idstringобязательный
ID пользователя или '@me' для текущего пользователя

user_update_permissions

Обновить разрешения пользователя в Crafty и на отдельных серверах

Параметры

permissionsobjectобязательный
Конфигурация прав доступа для обновления.
user_idstringобязательный
ID пользователя

0.1.2основная

23.03.2026

Выберите клиент, чтобы установить HadiCherkaoui/crafty-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "hadicherkaoui-crafty-mcp-f6s0ui8udi": {
      "command": "npx",
      "args": [
        "-y",
        "crafty-mcp"
      ],
      "env": {
        "CRAFTY_URL": "https://localhost:8443",
        "CRAFTY_API_TOKEN": "your-bearer-token",
        "CRAFTY_ALLOW_INSECURE": "true"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "hadicherkaoui-crafty-mcp-f6s0ui8udi": {
      "command": "npx",
      "args": [
        "-y",
        "crafty-mcp"
      ],
      "env": {
        "CRAFTY_URL": "https://localhost:8443",
        "CRAFTY_API_TOKEN": "your-bearer-token",
        "CRAFTY_ALLOW_INSECURE": "true"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "hadicherkaoui-crafty-mcp-f6s0ui8udi": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "crafty-mcp"
      ],
      "env": {
        "CRAFTY_URL": "https://localhost:8443",
        "CRAFTY_API_TOKEN": "your-bearer-token",
        "CRAFTY_ALLOW_INSECURE": "true"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"hadicherkaoui-crafty-mcp-f6s0ui8udi\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"crafty-mcp\"],\"env\":{\"CRAFTY_URL\":\"https://localhost:8443\",\"CRAFTY_API_TOKEN\":\"your-bearer-token\",\"CRAFTY_ALLOW_INSECURE\":\"true\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "hadicherkaoui-crafty-mcp-f6s0ui8udi": {
      "command": "npx",
      "args": [
        "-y",
        "crafty-mcp"
      ],
      "env": {
        "CRAFTY_URL": "https://localhost:8443",
        "CRAFTY_API_TOKEN": "your-bearer-token",
        "CRAFTY_ALLOW_INSECURE": "true"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add hadicherkaoui-crafty-mcp-f6s0ui8udi --env CRAFTY_URL=https://localhost:8443 --env CRAFTY_API_TOKEN=your-bearer-token --env CRAFTY_ALLOW_INSECURE=true -- npx -y crafty-mcp

Либо через JSON-конфиг:

claude mcp add-json hadicherkaoui-crafty-mcp-f6s0ui8udi "{\"command\":\"npx\",\"args\":[\"-y\",\"crafty-mcp\"],\"env\":{\"CRAFTY_URL\":\"https://localhost:8443\",\"CRAFTY_API_TOKEN\":\"your-bearer-token\",\"CRAFTY_ALLOW_INSECURE\":\"true\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add hadicherkaoui-crafty-mcp-f6s0ui8udi --env CRAFTY_URL=https://localhost:8443 --env CRAFTY_API_TOKEN=your-bearer-token --env CRAFTY_ALLOW_INSECURE=true -- npx -y crafty-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.hadicherkaoui-crafty-mcp-f6s0ui8udi]
command = "npx"
args = ["-y", "crafty-mcp"]

[mcp_servers.hadicherkaoui-crafty-mcp-f6s0ui8udi.env]
CRAFTY_URL = "https://localhost:8443"
CRAFTY_API_TOKEN = "your-bearer-token"
CRAFTY_ALLOW_INSECURE = "true"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите HadiCherkaoui/crafty-mcp, а в поле команды запуска — строку ниже:

npx -y crafty-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "hadicherkaoui-crafty-mcp-f6s0ui8udi": {
      "command": "npx",
      "args": [
        "-y",
        "crafty-mcp"
      ],
      "env": {
        "CRAFTY_URL": "https://localhost:8443",
        "CRAFTY_API_TOKEN": "your-bearer-token",
        "CRAFTY_ALLOW_INSECURE": "true"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "hadicherkaoui-crafty-mcp-f6s0ui8udi": {
      "command": "npx",
      "args": [
        "-y",
        "crafty-mcp"
      ],
      "env": {
        "CRAFTY_URL": "https://localhost:8443",
        "CRAFTY_API_TOKEN": "your-bearer-token",
        "CRAFTY_ALLOW_INSECURE": "true"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например hadicherkaoui-crafty-mcp-f6s0ui8udi.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: hadicherkaoui-crafty-mcp-f6s0ui8udi
    command: npx
    args:
      - "-y"
      - "crafty-mcp"
    env:
      CRAFTY_URL: https://localhost:8443
      CRAFTY_API_TOKEN: your-bearer-token
      CRAFTY_ALLOW_INSECURE: true

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "hadicherkaoui-crafty-mcp-f6s0ui8udi": {
      "command": "npx",
      "args": [
        "-y",
        "crafty-mcp"
      ],
      "env": {
        "CRAFTY_URL": "https://localhost:8443",
        "CRAFTY_API_TOKEN": "your-bearer-token",
        "CRAFTY_ALLOW_INSECURE": "true"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "crafty-mcp"
  ],
  "env": {
    "CRAFTY_URL": "https://localhost:8443",
    "CRAFTY_API_TOKEN": "your-bearer-token",
    "CRAFTY_ALLOW_INSECURE": "true"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx