beget-mcp 0.2.0__py3-none-any.whl

beget_mcp-0.2.0.dist-info/METADATA

@@ -0,0 +1,133 @@
+Metadata-Version: 2.5
+Name: beget-mcp
+Version: 0.2.0
+Summary: Beget hosting MCP server — manage sites, domains, MySQL, FTP, DNS, cron, backups via AI agents
+Project-URL: Homepage, https://badigit.github.io/beget-mcp/
+Project-URL: Repository, https://github.com/badigit/beget-mcp
+Project-URL: Issues, https://github.com/badigit/beget-mcp/issues
+License-Expression: MIT
+License-File: LICENSE
+Keywords: beget,claude,dns,hosting,mcp,model-context-protocol
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: System Administrators
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.11
+Requires-Dist: dnspython>=2.6
+Requires-Dist: mcp[cli]<2.0.0,>=1.27
+Requires-Dist: python-dotenv
+Requires-Dist: requests
+Provides-Extra: test
+Requires-Dist: pytest-mock>=3.12; extra == 'test'
+Requires-Dist: pytest-timeout>=2.3; extra == 'test'
+Requires-Dist: pytest>=8; extra == 'test'
+Requires-Dist: responses>=0.25; extra == 'test'
+Description-Content-Type: text/markdown
+
+# beget-mcp
+
+MCP-сервер для управления сервисами хостера [Beget](https://beget.com/p1211871) из AI-агентов.
+
+Построен на [FastMCP](https://github.com/modelcontextprotocol/python-sdk) и покрывает весь [Beget REST API](https://beget.com/p1211871/kb/api/) — 73 инструмента в 10 разделах.
+
+> [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) — открытый стандарт для подключения AI-моделей к внешним сервисам.
+
+<!-- mcp-name: io.github.badigit/beget-mcp -->
+
+## Быстрый старт
+
+Из PyPI, без установки в систему:
+
+```bash
+claude mcp add beget -s user \
+  -e BEGET_API_LOGIN=your_login \
+  -e BEGET_API_PASSWORD=your_password \
+  -- uvx beget-mcp
+```
+
+Контейнером (образ по умолчанию поднимает SSE — локальному клиенту нужен stdio):
+
+```bash
+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
+```
+
+Из исходников:
+
+```bash
+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](https://registry.modelcontextprotocol.io) под именем
+`io.github.badigit/beget-mcp`. Страница проекта — <https://badigit.github.io/beget-mcp/>.
+
+## Что умеет
+
+| Раздел | Инструменты | Примеры операций |
+|--------|------------|-----------------|
+| Сайты | 8 | создание, удаление, привязка доменов, заморозка файлов |
+| Домены | 13 | управление, поддомены, PHP-версии, директивы, проверка доступности |
+| DNS | 8 | A, CNAME, MX, TXT — безопасный merge; частичное обновление через `dns_patch_record`; `dns_verify` сверяет факт у авторитативного NS |
+| MySQL | 6 | базы, доступы с хостов, пароли |
+| FTP | 4 | аккаунты, домашние каталоги |
+| Cron | 7 | задачи, расписание, активация, email-отчёты |
+| Бэкапы | 9 | просмотр содержимого, откат, выгрузка файлов и БД |
+| Почта | 12 | ящики, пароли, спам-фильтр, пересылка, catch-all, one-shot-настройка Яндекс 360 / Mail.ru |
+| Статистика | 4 | нагрузка по сайтам и БД — сводная и детальная |
+| Аккаунт | 2 | тариф, баланс, SSH-доступ |
+
+## Документация
+
+| Файл | О чём |
+|------|-------|
+| [docs/api-coverage.md](docs/api-coverage.md) | покрытие методов Beget API |
+| [docs/beget-api-gotchas.md](docs/beget-api-gotchas.md) | грабли API: ошибка в success-конверте и прочее |
+| [docs/dns-facts-vs-intent.md](docs/dns-facts-vs-intent.md) | DNS: несозданный поддомен, catch-all зоны, задержка распространения |
+| [docs/new-app-deploy-chain.md](docs/new-app-deploy-chain.md) | цепочка вызовов для нового приложения на shared-хостинге |
+
+## Переменные окружения
+
+| Переменная | Назначение |
+|-----------|-----------|
+| `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](LICENSE)
+
+---
+
+Нет аккаунта на Beget? [Зарегистрируйтесь по ссылке](https://beget.com/p1211871) — вы получите хостинг, а автор проекта небольшой бонус.

beget_mcp-0.2.0.dist-info/RECORD

@@ -0,0 +1,25 @@
+mcp_beget/__init__.py,sha256=U2XUubedaDo1W9M-4i0Ku3Cu_OS0YcJqXitFaNK8SV4,32
+mcp_beget/__main__.py,sha256=7Xk07Z5FqO8nk63pllqVL23Rx3ltoLVB3dQOmt5diKE,42
+mcp_beget/app.py,sha256=9QYqp0tZVx9_jG-QQatkjdevCWy5bD6xo00PInVcyqw,286
+mcp_beget/client.py,sha256=4XaxbM1V7V5cJkHCdijc0kfSZdawf6nUenb3I1uia-I,4000
+mcp_beget/config.py,sha256=WEeNlC0aemPVgX1Bl6A8NPBvyIdCGoMSSDB2JY1xICs,763
+mcp_beget/dnsprobe.py,sha256=skDcb8XRCD7sQ2hFeOYkrHQW2ChEF6PIMTy4_QqhXLA,5237
+mcp_beget/errors.py,sha256=OF9SYa1HWR7VG0thmp9XSHr8uSbSLOw7KvjfCKrd7Tw,869
+mcp_beget/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mcp_beget/server.py,sha256=F-5GA-KEuAtSoWhPIbCXkRZOFeMNono8f13ebsouOrc,1435
+mcp_beget/tools/__init__.py,sha256=rkG6I3MP-WPyvvVPUCLQY9ztt-jpmbxJUY0r70P3g6M,317
+mcp_beget/tools/account.py,sha256=k5Gr-FpU7LQp069-sanc-JeMTS9VLbOD_pSTcUDS6oQ,2056
+mcp_beget/tools/annotations.py,sha256=UUS05FEiDFJDnmfACCyyFk5nqnunoTz6xkKVpT2Ax7U,361
+mcp_beget/tools/backup.py,sha256=ypnuyLTlbZNioXv3aSRMfuwv7SA0pGdPoDzyuosDe24,4116
+mcp_beget/tools/cron.py,sha256=-5VMZc5V6x0wcwEJI8oIGw09m0251j5XiekZq79a_-k,3823
+mcp_beget/tools/dns.py,sha256=jNDbSYNlCnziXWJztlyLnjpsRyjLCokj8nDHoy8GFU0,24702
+mcp_beget/tools/domains.py,sha256=sXU5C5acYAAfAI6WEW6zgIRD_30tS6UtwJKQ8Maudto,9817
+mcp_beget/tools/ftp.py,sha256=LNlN0H-q5VAIoDweFNoga85A3Vp2kFVNGfwgfOq-BTI,1641
+mcp_beget/tools/mail.py,sha256=dCkPHMjanGXQuyV49lDio00nRsqJsvHoAfXUzik1HKQ,8943
+mcp_beget/tools/mysql.py,sha256=oaUsdi_T5WQd5AVMRpZAj3puPxY7HpyW6AToSKKFTRM,2924
+mcp_beget/tools/sites.py,sha256=UXSFVizaxyGFxbZpG-nxkovkjY3_tDjnoUSzh52IRv4,2896
+beget_mcp-0.2.0.dist-info/METADATA,sha256=fuW4B1x1rUo6JOIIPXKoPM5ggK_-Y-cE-pQOMgXchuA,5944
+beget_mcp-0.2.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+beget_mcp-0.2.0.dist-info/entry_points.txt,sha256=pxdroKGdeiFQ3ZjrdZd4z79aevS16hGsDqbTSPwjrJA,52
+beget_mcp-0.2.0.dist-info/licenses/LICENSE,sha256=ypGhcEZ4LiShahUXjxsR890b-iYikO0uEfkPZloEm70,1060
+beget_mcp-0.2.0.dist-info/RECORD,,

beget_mcp-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

beget_mcp-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+beget-mcp = mcp_beget.server:main

beget_mcp-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mcp_beget/__init__.py

@@ -0,0 +1 @@
+"""Beget hosting MCP server."""

mcp_beget/__main__.py

@@ -0,0 +1,3 @@
+from mcp_beget.server import main
+
+main()

mcp_beget/app.py

@@ -0,0 +1,10 @@
+from mcp.server.fastmcp import FastMCP
+
+mcp = FastMCP(
+    "beget-api",
+    instructions=(
+        "Beget hosting management server. "
+        "Manage sites, domains, MySQL databases, FTP accounts, "
+        "DNS records, cron jobs, backups, and mail on Beget shared hosting."
+    ),
+)

mcp_beget/client.py

@@ -0,0 +1,111 @@
+"""Beget REST API client with session reuse and structured errors."""
+
+import json
+import logging
+
+import requests
+
+from .config import BegetConfig
+from .errors import BegetAPIError, BegetAuthError
+
+log = logging.getLogger(__name__)
+
+_client: "BegetClient | None" = None
+
+
+def init_client(config: BegetConfig) -> "BegetClient":
+    global _client
+    _client = BegetClient(config)
+    return _client
+
+
+def get_client() -> "BegetClient":
+    if _client is None:
+        raise RuntimeError("BegetClient not initialised — call init_client() first")
+    return _client
+
+
+class BegetClient:
+    """Thin wrapper around Beget shared-hosting REST API.
+
+    All endpoints follow ``POST /api/{section}/{method}`` with:
+      - query string: ``output_format=json``
+      - form body: ``login``, ``passwd``, and when ``params`` is given
+        ``input_format=json`` + ``input_data=<json>``.
+
+    Credentials go in the POST body (not query string) so they don't leak into
+    access logs / proxy logs. Log lines here redact ``passwd``.
+    """
+
+    API_BASE = "https://api.beget.com/api"
+
+    def __init__(self, config: BegetConfig) -> None:
+        self._cfg = config
+        self._http = requests.Session()
+
+    def call(self, section: str, method: str, params: dict | None = None) -> dict:
+        """Execute an API method and return the parsed answer.
+
+        Raises:
+            BegetAuthError: credentials rejected.
+            BegetAPIError: any other API-level failure.
+            requests.HTTPError: transport-level failure.
+        """
+        endpoint = f"{self.API_BASE}/{section}/{method}"
+
+        data: dict = {
+            "login": self._cfg.login,
+            "passwd": self._cfg.password,
+        }
+        if params is not None:
+            data["input_format"] = "json"
+            data["input_data"] = json.dumps(params)
+
+        log.debug("%s/%s params=%s", section, method, params)
+
+        resp = self._http.post(
+            endpoint,
+            params={"output_format": "json"},
+            data=data,
+            timeout=self._cfg.timeout,
+        )
+        resp.raise_for_status()
+
+        body: dict = resp.json()
+
+        if body.get("status") == "success":
+            answer = body.get("answer", {})
+            # Beget отдаёт HTTP-200 и status:success на конверте, а собственную
+            # ошибку метода кладёт внутрь answer (METHOD_FAILED, INVALID_DATA).
+            # Без этой ветки error-объект уходит наверх как валидный ответ:
+            # вызывающий код видит "успех", а except BegetAPIError не срабатывает.
+            if isinstance(answer, dict) and answer.get("status") == "error":
+                errs = answer.get("errors") or []
+                first = errs[0] if errs and isinstance(errs[0], dict) else {}
+                err_text = first.get("error_text") or "Method failed"
+                err_code = first.get("error_code", "")
+                if err_code == "AUTH_ERROR":
+                    raise BegetAuthError(err_text, code=err_code, details=body)
+                raise BegetAPIError(err_text, code=err_code, details=body)
+            return answer
+
+        err_msg = body.get("error_text", "")
+        err_code = body.get("error_code", "")
+
+        # nested errors (some endpoints wrap errors in answer.errors[])
+        if not err_msg and "answer" in body:
+            answer = body["answer"]
+            if isinstance(answer, dict) and "errors" in answer:
+                errs = answer["errors"]
+                if errs:
+                    err_msg = errs[0].get("error_text", "Unknown error")
+                    err_code = errs[0].get("error_code", err_code)
+
+        if err_code == "AUTH_ERROR":
+            raise BegetAuthError(err_msg or "Bad credentials", code=err_code)
+
+        raise BegetAPIError(
+            err_msg or "Unknown error",
+            code=err_code,
+            details=body,
+        )

mcp_beget/config.py

@@ -0,0 +1,31 @@
+import logging
+import os
+from dataclasses import dataclass
+
+from dotenv import load_dotenv
+
+log = logging.getLogger(__name__)
+
+
+@dataclass(frozen=True)
+class BegetConfig:
+    login: str
+    password: str
+    timeout: int = 30
+
+    def __post_init__(self) -> None:
+        if not self.login or not self.password:
+            raise ValueError(
+                "BEGET_API_LOGIN and BEGET_API_PASSWORD must be set. "
+                "Pass them as environment variables or in a .env file."
+            )
+
+
+def load_config() -> BegetConfig:
+    load_dotenv()
+    config = BegetConfig(
+        login=os.getenv("BEGET_API_LOGIN", ""),
+        password=os.getenv("BEGET_API_PASSWORD", ""),
+    )
+    log.info("Config loaded for user '%s'", config.login)
+    return config

mcp_beget/dnsprobe.py

@@ -0,0 +1,122 @@
+"""Опрос авторитативного NS зоны — факт вместо намерения.
+
+Beget API отвечает `success` на запись, а `dns/getData` подтверждает её, потому
+что читает тот же источник, куда писал. Мир в этот момент может ещё получать
+старое значение: авторитативный NS обновляется с задержкой в несколько минут.
+Отдельно у зоны бывает catch-all на shared-хостинг, которого в `dns/getData` не
+видно вовсе — имя резолвится, хотя записи в зоне нет.
+
+Модуль ходит к авторитативным NS напрямую по UDP, минуя рекурсивный резолвер и
+его кеш. dnspython — обязательная зависимость, но её отсутствие не должно ронять
+DNS-тулы целиком: `probe()` в этом случае возвращает поле ``error``.
+"""
+
+DEFAULT_TIMEOUT = 5.0
+
+
+class ProbeUnavailable(Exception):
+    """Факт получить не удалось — сеть, отсутствие NS или нет dnspython."""
+
+
+def _dnspython():
+    try:
+        import dns.message  # noqa: F401
+        import dns.query  # noqa: F401
+        import dns.rcode  # noqa: F401
+        import dns.rdatatype  # noqa: F401
+        import dns.resolver  # noqa: F401
+    except ImportError as e:  # pragma: no cover - зависит от окружения
+        raise ProbeUnavailable(
+            "dnspython is not installed — authoritative DNS probing disabled"
+        ) from e
+    import dns
+
+    return dns
+
+
+def authoritative_nameservers(
+    fqdn: str, timeout: float = DEFAULT_TIMEOUT
+) -> tuple[str, list[str]]:
+    """(зона, её NS) — идём вверх по меткам до первой зоны с NS-записями.
+
+    Для ``sub.site.ru`` NS обычно делегированы на уровне ``site.ru``, поэтому
+    запрос по самому поддомену ничего не даёт и подниматься обязательно.
+    """
+    dns = _dnspython()
+    resolver = dns.resolver.Resolver()
+    resolver.timeout = timeout
+    resolver.lifetime = timeout
+
+    labels = fqdn.split(".")
+    for i in range(len(labels) - 1):
+        zone = ".".join(labels[i:])
+        try:
+            answer = resolver.resolve(zone, "NS")
+        except Exception:
+            continue
+        servers = sorted({str(r.target).rstrip(".") for r in answer})
+        if servers:
+            return zone, servers
+    raise ProbeUnavailable(f"no NS records found for {fqdn} or any parent zone")
+
+
+def _nameserver_addresses(dns, resolver, name: str) -> list[str]:
+    addresses: list[str] = []
+    for rdtype in ("A", "AAAA"):
+        try:
+            answer = resolver.resolve(name, rdtype)
+        except Exception:
+            continue
+        addresses.extend(str(r) for r in answer)
+    return addresses
+
+
+def query_authoritative(
+    fqdn: str, rtype: str = "A", timeout: float = DEFAULT_TIMEOUT
+) -> dict:
+    """Спросить авторитативный NS зоны напрямую. Кеш резолвера не участвует.
+
+    Raises:
+        ProbeUnavailable: ни один авторитативный NS не ответил.
+    """
+    dns = _dnspython()
+    zone, nameservers = authoritative_nameservers(fqdn, timeout)
+
+    resolver = dns.resolver.Resolver()
+    resolver.timeout = timeout
+    resolver.lifetime = timeout
+
+    errors: list[str] = []
+    for ns in nameservers:
+        for address in _nameserver_addresses(dns, resolver, ns):
+            try:
+                query = dns.message.make_query(fqdn, dns.rdatatype.from_text(rtype))
+                response = dns.query.udp(query, address, timeout=timeout)
+            except Exception as e:
+                errors.append(f"{ns} ({address}): {type(e).__name__}: {e}")
+                continue
+            values: list[str] = []
+            for rrset in response.answer:
+                values.extend(str(item).rstrip(".") for item in rrset)
+            return {
+                "zone": zone,
+                "nameserver": ns,
+                "nameserver_ip": address,
+                "type": rtype.upper(),
+                "values": sorted(values),
+                "rcode": dns.rcode.to_text(response.rcode()),
+            }
+    raise ProbeUnavailable(
+        f"no authoritative nameserver of {zone} answered for {fqdn}: "
+        + ("; ".join(errors) if errors else "no reachable NS addresses")
+    )
+
+
+def probe(fqdn: str, rtype: str = "A", timeout: float = DEFAULT_TIMEOUT) -> dict:
+    """query_authoritative, но без исключений — для встраивания в ответ тула."""
+    try:
+        return query_authoritative(fqdn, rtype, timeout)
+    except ProbeUnavailable as e:
+        return {"type": rtype.upper(), "error": str(e)}
+    except Exception as e:  # pragma: no cover - защита от неожиданного из dnspython
+        return {"type": rtype.upper(), "error": f"{type(e).__name__}: {e}"}

mcp_beget/errors.py

@@ -0,0 +1,22 @@
+class BegetError(Exception):
+    """Base error for Beget API calls."""
+
+    def __init__(self, message: str, code: str = "", details: dict | None = None):
+        self.message = message
+        self.code = code
+        self.details = details or {}
+        super().__init__(message)
+
+    def __str__(self) -> str:
+        # MCP отдаёт наружу только str(exc): без кода агент видит голый текст
+        # вроде "Failed to get DNS records" и не может отличить METHOD_FAILED
+        # от INVALID_DATA, чтобы выбрать следующий шаг.
+        return f"[{self.code}] {self.message}" if self.code else self.message
+
+
+class BegetAuthError(BegetError):
+    """Authentication failed — wrong login or password."""
+
+
+class BegetAPIError(BegetError):
+    """API returned an error response."""

mcp_beget/server.py

@@ -0,0 +1,52 @@
+import logging
+import os
+import sys
+
+from .app import mcp
+from .client import init_client
+from .config import load_config
+
+# Configure logging to stderr (stdout is reserved for MCP protocol)
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s [%(name)s] %(levelname)s: %(message)s",
+    stream=sys.stderr,
+)
+log = logging.getLogger(__name__)
+
+
+def main() -> None:
+    log.info("Starting Beget MCP server")
+
+    try:
+        config = load_config()
+    except ValueError as e:
+        log.error("Configuration error: %s", e)
+        sys.exit(1)
+
+    init_client(config)
+
+    # Import tools so @mcp.tool() decorators register them
+    import mcp_beget.tools  # noqa: F401
+
+    transport = os.getenv("MCP_TRANSPORT", "stdio")
+
+    if transport in ("sse", "streamable-http"):
+        host = os.getenv("MCP_HOST", "0.0.0.0")
+        port = int(os.getenv("MCP_PORT", "8322"))
+
+        mcp.settings.host = host
+        mcp.settings.port = port
+        mcp.settings.stateless_http = True
+
+        from mcp.server.transport_security import TransportSecuritySettings
+
+        mcp.settings.transport_security = TransportSecuritySettings(
+            enable_dns_rebinding_protection=False,
+        )
+
+        log.info("Tools registered, starting %s server on %s:%d", transport, host, port)
+        mcp.run(transport=transport)
+    else:
+        log.info("Tools registered, running stdio server")
+        mcp.run(transport="stdio")

mcp_beget/tools/__init__.py

@@ -0,0 +1,11 @@
+"""Import all tool modules so their @mcp.tool() decorators fire."""
+
+import json
+
+
+def _json(data: dict) -> str:
+    """Serialize API response for MCP output."""
+    return json.dumps(data, ensure_ascii=False, indent=2)
+
+
+from . import account, backup, cron, dns, domains, ftp, mail, mysql, sites  # noqa: F401, E402

mcp_beget/tools/account.py

@@ -0,0 +1,56 @@
+from ..app import mcp
+from ..client import get_client
+from . import _json
+from .annotations import MUTATING, READ_ONLY
+
+
+@mcp.tool(annotations=READ_ONLY)
+def account_info() -> str:
+    """Сведения об аккаунте: баланс, тариф, ресурсы, сервер."""
+    return _json(get_client().call("user", "getAccountInfo"))
+
+
+@mcp.tool(annotations=MUTATING)
+def toggle_ssh(status: int, ftplogin: str = "") -> str:
+    """Переключить SSH-доступ для основного или FTP-аккаунта.
+
+    Args:
+        status: 1 = включить, 0 = выключить
+        ftplogin: Логин FTP-аккаунта (если пусто — применяется к основному аккаунту)
+    """
+    params: dict = {"status": status}
+    if ftplogin:
+        params["ftplogin"] = ftplogin
+    return _json(get_client().call("user", "toggleSsh", params))
+
+
+@mcp.tool(annotations=READ_ONLY)
+def stat_site_list_load() -> str:
+    """Средняя нагрузка по всем сайтам за месяц."""
+    return _json(get_client().call("stat", "getSitesListLoad"))
+
+
+@mcp.tool(annotations=READ_ONLY)
+def stat_db_list_load() -> str:
+    """Средняя нагрузка по всем базам данных за месяц."""
+    return _json(get_client().call("stat", "getDbListLoad"))
+
+
+@mcp.tool(annotations=READ_ONLY)
+def stat_site_load(site_id: int) -> str:
+    """Детальная статистика нагрузки сайта (почасовая и посуточная за месяц).
+
+    Args:
+        site_id: ID сайта
+    """
+    return _json(get_client().call("stat", "getSiteLoad", {"site_id": site_id}))
+
+
+@mcp.tool(annotations=READ_ONLY)
+def stat_db_load(db_name: str) -> str:
+    """Детальная статистика нагрузки БД: CPU, размер, почасовая и посуточная.
+
+    Args:
+        db_name: Имя базы данных
+    """
+    return _json(get_client().call("stat", "getDbLoad", {"db_name": db_name}))

mcp_beget/tools/annotations.py

@@ -0,0 +1,19 @@
+from mcp.types import ToolAnnotations
+
+READ_ONLY = ToolAnnotations(
+    readOnlyHint=True,
+    destructiveHint=False,
+    openWorldHint=False,
+)
+
+MUTATING = ToolAnnotations(
+    readOnlyHint=False,
+    destructiveHint=False,
+    openWorldHint=False,
+)
+
+DESTRUCTIVE = ToolAnnotations(
+    readOnlyHint=False,
+    destructiveHint=True,
+    openWorldHint=False,
+)