Beget Hosting

beget-mcp

AI エージェントからホスティングプロバイダー Beget のサービスを管理する MCP サーバーです。

FastMCP 上に構築されており、Beget REST API 全体をカバーしています。10 セクションにわたる 73 個のツールを提供します。

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 バージョン、ディレクティブ、利用可能状況の確認
DNS	8	A、CNAME、MX、TXT — 安全なマージ、dns_patch_record による部分更新、dns_verify による権威 NS 上の実際の状態との照合
MySQL	6	データベース、ホストからのアクセス、パスワード
FTP	4	アカウント、ホームディレクトリ
Cron	7	タスク、スケジュール、有効化、メールレポート
バックアップ	9	内容の表示、ロールバック、ファイルと DB のエクスポート
メール	12	メールボックス、パスワード、スパムフィルター、転送、キャッチオール、Yandex 360 / Mail.ru のワンショット設定
統計	4	サイトと DB の負荷 — 概要と詳細
アカウント	2	プラン、残高、SSH アクセス

ドキュメント

ファイル	内容
docs/api-coverage.md	Beget API メソッドのカバレッジ
docs/beget-api-gotchas.md	API の注意点：success エンベロープのエラーなど
docs/dns-facts-vs-intent.md	DNS：未作成のサブドメイン、キャッチオールゾーン、伝播の遅延
docs/new-app-deploy-chain.md	共有ホスティング上の新しいアプリケーションの呼び出しチェーン

リリースとデプロイ

• main への push = 本番ホストへのデプロイです。 .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、タグで一致している必要があります。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

コントリビューション

Issues と pull requests を歓迎します。バグを見つけた場合や改善案がある場合は、issue を作成してください。

ライセンス

MIT

---

Beget のアカウントをお持ちでない場合は、こちらのリンクから登録してください。ホスティングを利用でき、プロジェクトの作者には少額のボーナスが入ります。