mcpField
D
dockerized-mcpaper-server

dockerized-mcpaper-server

ローカル
github.com/LeoMaininiゲーム・エンタメ044 週間前に更新

dockerized-mcpaper-server について

再現性と移植性を備えた Minecraft サーバーを構築する Docker Compose 設定です。主に PaperMC 向けで、compose ファイルで主要設定を行い、マウントしたフォルダーにデータを保存できます。

主な機能

  1. 01Docker での Minecraft サーバー実行
  2. 02PaperMC 向け設定
  3. 03Compose による起動と停止
  4. 04サーバーデータの永続化
  5. 05ポートとメモリの設定

活用シーン

  1. 01コンテナでの PaperMC サーバー運用
  2. 02Docker Compose でのサーバー設定
  3. 03コンテナ再構築後のサーバーファイル保持

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"dockerized-mcpaper-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"compose"
]
}
}
}
起動コマンドdocker run -i --rm compose

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
ocicompose

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

コンテナ化された Minecraft サーバー 🐋🧱

このプロジェクトでは、シンプルで再現性があり、移行可能な Docker コンテナを使用して Minecraft サーバーを作成する作業を自動化します。

この設定は PaperMC サーバーソフトウェアの要件に合わせて構築されています。ほかの実行可能な種類も使用できますが、動作は保証されません。

要件

Docker Engine
PaperMC サーバーのダウンロード URL

使用方法

docker-compose.yml では、一部の設定をユーザーに委ねています。必須の入力項目は次のとおりです。

  • OUT_PORT
  • SERVER_JAR_URL
  • DEDICATED_RAM

それ以外の入力項目はすべて省略可能で、server.properties ファイルを直接編集せずに値を変更できるように用意されています。

  1. docker-compose.yaml で URL、出力ポート、専用 RAM を設定します

  2. ベースフォルダーから docker compose up -d を実行してサーバーを起動します

    • サーバーコンソールに接続するには、docker attach <container_name> を実行します
    • 接続を解除するには、ターミナルウィンドウ内で CTRL+P+Q を押します
  3. docker compose down を実行してサーバーを停止します

知っておくと便利なこと

コンテナから追加のフォルダーを永続化する

サーバーの永続データは ./volumes/server にマウントされます。サーバーの実行可能ファイルがあるフォルダー内のデータはすべて永続化されます。

ほかのフォルダーも永続化する必要がある場合は、次のように docker-compose.yaml の volumes セクションに別の項目を追加してください。

- type: bind
  source: <HOST PATH>
  target: <PATH IN CONTAINER>

ワールドのバックアップの例:

- type: bind
  source: /volume/backups
  target: /world_backups
Dockerfile の変更を反映するためにイメージを再ビルドする

Dockerfile、依存関係、Java のバージョンなどに変更がある場合、変更を反映するにはイメージを再ビルドする必要があります。

docker compose up --build

永続化されているデータはイメージを再ビルドしても削除されません。削除するには、永続化されたフォルダーを手動で削除する必要があります。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。