English Français العربية

Beget Hosting

السجل الرسمي البيانات وقواعدها

Beget hosting: sites, domains, DNS, MySQL, FTP, cron, backups, mail — 73 tools

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package beget-mcp
Claude Code 
claude mcp add beget-hosting -e 'BEGET_API_LOGIN=<BEGET_API_LOGIN>' -e 'BEGET_API_PASSWORD=<your beget_api_password>' -- uvx beget-mcp==0.2.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "beget-hosting": {
            "command": "uvx",
            "args": [
                "beget-mcp==0.2.0"
            ],
            "env": {
                "BEGET_API_LOGIN": "<BEGET_API_LOGIN>",
                "BEGET_API_PASSWORD": "<your beget_api_password>"
            }
        }
    }
}

متغيرات البيئة

  • BEGET_API_LOGIN إلزامي Beget account login
  • BEGET_API_PASSWORD إلزامي سري Beget account password (API access must be enabled in the panel)
OCI package ghcr.io/badigit/beget-mcp:0.2.0
Claude Code 
claude mcp add beget-hosting -e 'BEGET_API_LOGIN=<BEGET_API_LOGIN>' -e 'BEGET_API_PASSWORD=<your beget_api_password>' -e 'MCP_TRANSPORT=stdio' -- docker run -i --rm ghcr.io/badigit/beget-mcp:0.2.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "beget-hosting": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/badigit/beget-mcp:0.2.0"
            ],
            "env": {
                "BEGET_API_LOGIN": "<BEGET_API_LOGIN>",
                "BEGET_API_PASSWORD": "<your beget_api_password>",
                "MCP_TRANSPORT": "stdio"
            }
        }
    }
}

متغيرات البيئة

  • BEGET_API_LOGIN إلزامي Beget account login
  • BEGET_API_PASSWORD إلزامي سري Beget account password (API access must be enabled in the panel)
  • MCP_TRANSPORT إلزامي Transport: stdio for local clients, sse for a shared HTTP deployment. The image defaults to sse, so stdio clients must set this.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. beget-mcp
  2. Быстрый старт
  3. Что умеет
  4. Документация
  5. Релиз и деплой
  6. Переменные окружения
  7. Архитектура
  8. Требования
  9. Contributing
  10. Лицензия

beget-mcp

MCP-сервер для управления сервисами хостера Beget из AI-агентов.

Построен на FastMCP и покрывает весь Beget REST API — 73 инструмента в 10 разделах.

Model Context Protocol (MCP) — открытый стандарт для подключения AI-моделей к внешним сервисам.

Быстрый старт

Из PyPI, без установки в систему:

claude mcp add beget -s user \
  -e BEGET_API_LOGIN=your_login \
  -e BEGET_API_PASSWORD=your_password \
  -- uvx beget-mcp

Контейнером (образ по умолчанию поднимает SSE — локальному клиенту нужен stdio):

docker run -i --rm \
  -e MCP_TRANSPORT=stdio \
  -e BEGET_API_LOGIN=your_login \
  -e BEGET_API_PASSWORD=your_password \
  ghcr.io/badigit/beget-mcp:latest

Из исходников:

pip install -e .

claude mcp add beget -s user \
  -e BEGET_API_LOGIN=your_login \
  -e BEGET_API_PASSWORD=your_password \
  -- python -m mcp_beget

Сервер публикуется в MCP Registry под именем io.github.badigit/beget-mcp. Страница проекта — https://badigit.github.io/beget-mcp/.

Что умеет

РазделИнструментыПримеры операций
Сайты8создание, удаление, привязка доменов, заморозка файлов
Домены13управление, поддомены, PHP-версии, директивы, проверка доступности
DNS8A, CNAME, MX, TXT — безопасный merge; частичное обновление через dns_patch_record; dns_verify сверяет факт у авторитативного NS
MySQL6базы, доступы с хостов, пароли
FTP4аккаунты, домашние каталоги
Cron7задачи, расписание, активация, email-отчёты
Бэкапы9просмотр содержимого, откат, выгрузка файлов и БД
Почта12ящики, пароли, спам-фильтр, пересылка, catch-all, one-shot-настройка Яндекс 360 / Mail.ru
Статистика4нагрузка по сайтам и БД — сводная и детальная
Аккаунт2тариф, баланс, SSH-доступ

Документация

ФайлО чём
docs/api-coverage.mdпокрытие методов Beget API
docs/beget-api-gotchas.mdграбли API: ошибка в success-конверте и прочее
docs/dns-facts-vs-intent.mdDNS: несозданный поддомен, catch-all зоны, задержка распространения
docs/new-app-deploy-chain.mdцепочка вызовов для нового приложения на shared-хостинге

Релиз и деплой

  • push в main = выкатка на боевой хост. .github/workflows/deploy.yml дёргает на VPS forced-command deploy, который пересобирает контейнер из /opt/beget-mcp. Отдельного ручного шага нет — правка в main уезжает на прод сама.
  • тег vX.Y.Z = публикация пакетов. publish-mcp.yml гонит тесты и заливает PyPI (trusted publishing), GHCR и MCP Registry — всё по OIDC, без секретов. Версия обязана совпадать в pyproject.toml, server.json и теге: workflow сверяет их до заливки, потому что версию на PyPI не перезалить.

Переменные окружения

ПеременнаяНазначение
BEGET_API_LOGINЛогин Beget
BEGET_API_PASSWORDПароль Beget

Архитектура

src/mcp_beget/
├── app.py       — экземпляр FastMCP
├── config.py    — конфигурация (dataclass + валидация)
├── client.py    — HTTP-клиент с переиспользованием сессии
├── errors.py    — типизированные исключения (Auth / API)
├── server.py    — точка входа, инициализация, логирование
└── tools/       — инструменты, сгруппированные по разделам API

Требования

  • Python >= 3.11
  • mcp[cli]
  • requests
  • python-dotenv

Contributing

Issues и pull requests приветствуются. Если нашли баг или хотите предложить улучшение — создайте issue.

Лицензия

MIT

Нет аккаунта на Beget? Зарегистрируйтесь по ссылке — вы получите хостинг, а автор проекта небольшой бонус.

الأسئلة الشائعة

ما هو Beget Hosting؟

Beget hosting: sites, domains, DNS, MySQL, FTP, cron, backups, mail — 73 tools

كيف أثبّت Beget Hosting؟

يعمل على جهازك. في Claude Code: claude mcp add beget-hosting -e 'BEGET_API_LOGIN=<BEGET_API_LOGIN>' -e 'BEGET_API_PASSWORD=<your beget_api_password>' -- uvx beget-mcp==0.2.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Beget Hosting إلى مفتاح API؟

نعم. يتطلب BEGET_API_LOGIN, BEGET_API_PASSWORD, MCP_TRANSPORT، وتضبطها في إعداداته.

هل Beget Hosting مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Beget Hosting؟

ينشره badigit. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.