mcpField
M
Minecraft

Minecraft

ローカル
github.comゲーム・エンタメ0今日更新
リポジトリ公式サイト

Minecraft について

Minecraft は、WorldAPI 経由で Paper サーバーを確認・管理する、プレイヤーや運営者向けの MCP サーバーです。ゲーム状態、設定、ログ、ライブイベントを扱い、操作範囲はトークンの権限で制御します。

主な機能

  1. 01プレイヤー、ワールド、ブロック、エンティティの確認
  2. 02設定とログの読み取り・編集
  3. 03詳細なインベントリ情報の確認
  4. 04サーバーのライブイベント購読
  5. 05トークン権限によるアクセス制御

活用シーン

  1. 01オンラインのプレイヤーと位置の確認
  2. 02ログを使ったサーバー遅延の調査
  3. 03プレイヤーへのアイテム付与や時刻変更
  4. 04プレイヤー参加時の通知

MCP 対応

Minecraft サーバーのデータと操作を MCP ツールとして公開し、Paper サーバー上の WorldAPI に接続します。stdio または HTTP 経由で MCP クライアントから利用できます。

設定

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

mcp.json · 共通設定
{
  "mcpServers": {
    "com-mairwunnx-minecraft": {
      "command": "npx",
      "args": [
        "-y",
        "@mairwunnx/minecraft-mcp"
      ],
      "env": {
        "WORLDAPI_URL": "<WORLDAPI_URL>",
        "WORLDAPI_TOKEN": "<WORLDAPI_TOKEN>",
        "WORLDAPI_READ_ONLY": "<WORLDAPI_READ_ONLY>"
      }
    }
  }
}
起動コマンドnpx -y @mairwunnx/minecraft-mcp
設定が必要な環境変数
WORLDAPI_URLWorldAPI base URL including /api/v1, such as http://localhost:8110/api/v1. Leave it out for the singleplayer world open on this machine with the WorldAPI mod.
WORLDAPI_TOKENシークレットA WorldAPI token; its permissions decide which tools the agent gets. Leave empty for what anonymous clients may read.
WORLDAPI_READ_ONLY1 hides every tool that changes the server

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

パッケージ
npm@mairwunnx/minecraft-mcp4.1.1

ツール

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

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

詳細

minecraft-mcp

npm MCP Registry Release

🤖 minecraft-mcp を使うと、AI エージェントが Minecraft サーバーの状態を確認したり、操作したりできます。「誰がオンラインで、どこにいる？」「サーバーがラグいのはなぜ？」「みんなにパンを配って、時刻を朝にして」と Claude に尋ねると、ワールドの実データを使って回答します。

このツールは AI クライアント（Claude Desktop、Claude Code、Cursor、VS Code など、MCP に対応するもの）と一緒に動作し、あらゆる Paper サーバー上の WorldAPI と通信します。エージェントができることは、設定したトークンによって決まります。

ロシア語版

できること

  • 🧰 サーバー、ワールド、ブロック、チェスト、エンティティ、プレイヤー、ランキング、レシピ、設定、ログ、Java スクリプト用の73 個のツール。
  • 🎒 インベントリを詳しく確認：すべてのアイテムのエンチャント、耐久度、ポーション効果に加え、シュルカーボックスやバンドルの中身も確認できます。
  • 📜 設定とログ：エージェントはコンソールとあらゆる設定を読み取れます。また、適切なトークンがあれば、コメントを保持したまま値を変更できます。
  • 🔑 トークンで許可された操作のみ：ビューワートークンでは参照専用のツールが 29 個表示され、読み取り専用モードでは書き込み操作がすべて非表示になります。
  • 🙋 「自分」はあなたのこと：プレイヤー名を設定すれば、「自分はどこ？」という質問にすぐ答えます。
  • ⏳ リアルタイムイベント：「Steve が参加したら教えて」。
  • 🛡️ 安全性を重視した設計：ゲーム内のテキストはデータとして区切られ、ツールは何かを破壊する場合に通知し、トークンが漏れることはありません。
  • 🔌 あらゆるクライアントに対応：Claude Desktop ならワンクリックで、stdio または HTTP 経由ならあらゆる MCP クライアントで利用できます。

はじめに

  1. Paper サーバーに WorldAPI 3.0.0 以降をインストールし、/worldapi token create agent でトークンを作成します。

  2. クライアントに minecraft-mcp を追加します。Claude Desktop では、minecraft-mcp.mcpb を開きます。Claude Code では次のようにします。

    claude mcp add minecraft -e WORLDAPI_URL=http://localhost:8110/api/v1 -e WORLDAPI_TOKEN=your-token -- npx -y @mairwunnx/minecraft-mcp

  3. 「サーバーの状態は？」と尋ねます。インストールページでは、Cursor、VS Code、HTTP の設定方法を説明しています。

ライブ環境で試す

友人と遊んでいる高難易度のサバイバルサーバー、Moonlands は WorldAPI を導入しており、誰でも読み取りできます。トークンなしでエージェントを接続してください。

claude mcp add moonlands -e WORLDAPI_URL=https://minecraft.mairwunnx.com/worldapi/api/v1 -- npx -y @mairwunnx/minecraft-mcp

それから「今週 Moonlands を最も長くプレイしたのは誰？」と尋ねてみてください。

Moonlands でプレイ：純粋なバニラ、高難易度のモブ、AI、領地保護。minecraft.mairwunnx.com

ドキュメント

その他の情報はすべてwikiにあります。

プレイヤーおよびサーバー所有者向け

開発者向け

関連プロジェクト

  • Moonlands—これらすべてが稼働する、ハードサバイバルサーバーです。
  • WorldAPI—Paper サーバーのワールド、プレイヤー、統計情報を扱う REST および WebSocket API です。
  • Allay—ゲーム内の AI ヘルパーです。チャットで /ask を使って質問できます。
  • Allay Server—Allay のバックエンドです。
  • Mo’Joins—各プレイヤーの言語で参加・退出メッセージを表示します。
  • Mo’Afks—夜を妨げない、安全な AFK モードです。
  • Mo’Bosses—クラス、能力、戦利品を備えたボスとして出現するモンスターです。
  • minecraft-exporter—WorldAPI から Prometheus メトリクスを取得します。
  • minecraft-grafana—WorldAPI 用の Grafana ダッシュボードです。

🫡 Pavel Erokhin（Павел Ерохин）、別名 mairwunnx が制作しました。

コメント

Markdown 対応

MCP は初めてですか？

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

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