AI导哈

Minecraft服务器控制服务

一个用于控制和自动化Minecraft服务器的服务，支持玩家追踪、资源采集、战斗模式等功能。

  • by GClue-Lab
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 GClue-Lab/minecraft_mcp_server

使用说明

Minecraft MCP 服务器

Minecraft MCP 服务器

Docker容器构建

docker pull node:22-slim
./build.sh

登录（确认周边情况后也请登录）

curl -X POST -H "Content-Type: application/json" \
     -d '{ "type": "connect", "id": "initiate-connection" }' \
     http://192.168.1.25:3000/command

确认周边情况

curl -X 'POST' \
  'http://192.168.1.45:8000/minecraft-mcp/minecraft_get_status' \
  -H 'accept: application/json' \
  -d ''

追踪玩家

curl -X 'POST' \
  'http://192.168.1.45:8000/minecraft-mcp/minecraft_set_follow_mode' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "mode": "on",
  "targetPlayer": "naisy714"
}'

解除对玩家的跟随

curl -X POST -H "Content-Type: application/json" \
     -d '{"type": "setFollowMode", "mode": "off"}' \
     http://192.168.1.25:3000/command

开启僵尸警戒模式

  • 在追踪玩家时，若警戒模式开启且出现僵尸，则会自动切换至驱除僵尸模式，待僵尸全部消灭后，再恢复追踪。
curl -X 'POST' \
  'http://192.168.1.45:8000/minecraft-mcp/minecraft_set_combat_mode' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"mode": "on"}'

关闭僵尸警戒模式

curl -X 'POST' \
  'http://192.168.1.45:8000/minecraft-mcp/minecraft_set_combat_mode' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"mode": "on"}'

开采10块石头

curl -X POST -H "Content-Type: application/json" \
     -d '{"type": "setMiningMode", "mode": "on", "blockName": "stone", "quantity": 10}' \
     http://192.168.1.25:3000/command

砍伐树木

curl -X POST -H "Content-Type: application/json" \
     -d '{"type": "setMiningMode", "mode": "on", "blockName": "oak_log", "quantity": 5}' \
     http://192.168.1.25:3000/command

采摘红蘑菇

curl -X 'POST' \
  'http://192.168.1.45:8000/minecraft-mcp/minecraft_set_mining_mode' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"blockName": "red_mushroom", "quantity": 1}'

采摘棕色蘑菇

curl -X 'POST' \
  'http://192.168.1.45:8000/minecraft-mcp/minecraft_set_mining_mode' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"blockName": "brown_mushroom", "quantity": 1}'

停止开采

curl -X 'POST' \
  'http://192.168.1.45:8000/minecraft-mcp/minecraft_stop_behavior' \
  -H 'accept: application/json' \
  -d ''

设定搜索敌情范围和攻击范围

curl -X POST -H "Content-Type: application/json" -d '{"type": "setCombatOptions", "maxCombatDistance": 10, "attackRange": 4}' http://192.168.1.25:3000/command

git clone https://github.com/GClue-Lab/minecraft_mcp_server
cd minecraft_mcp_server

npm install
npm run build

export MINECRAFT_SERVER_HOST="<あなたのMinecraftサーバーのIPアドレス>"
export MINECRAFT_SERVER_PORT="<あなたのMinecraftサーバーのポート>"
export BOT_USERNAME="MCP_CLI_Bot"
export MCP_SERVER_PORT="3000"

npm start

mcp-server/
├── src/
│   ├── main.ts                     # サーバーのエントリーポイント、初期化処理
│   ├── config/                     # 設定ファイル関連
│   │   └── index.ts                # 設定の読み込みと管理
│   │   └── default.ts              # デフォルト設定
│   ├── services/                   # 主要なサービスロジック
│   │   ├── BotManager.ts           # Mineflayerボットのライフサイクル管理（接続、切断、再接続、エラーハンドリング）
│   │   ├── CommandHandler.ts       # LLMからのMCPコマンド解釈と実行
│   │   ├── WorldKnowledge.ts       # Minecraftワールドの状態管理（地形、エンティティ、ブロックなど）
│   │   └── BehaviorEngine.ts       # 高レベルな行動ロジック（追従、採掘、戦闘など）
│   ├── behaviors/                  # 高レベルな行動の定義
│   │   ├── followPlayer.ts         # プレイヤー追従行動
│   │   ├── exploreArea.ts          # エリア探索行動
│   │   └── combatEnemy.ts          # 敵対エンティティとの戦闘行動
│   ├── utils/                      # 汎用ユーティリティ関数
│   │   ├── pathfindingUtils.ts     # 経路探索関連ユーティリティ
│   │   └── logger.ts               # ロギングユーティリティ
│   ├── api/                        # MCPのAPIエンドポイント定義
│   │   └── mcpApi.ts               # MCPコマンドの受信と`CommandHandler`への連携
│   ├── types/                      # TypeScriptの型定義ファイル
│   │   └── mcp.d.ts                # MCPコマンド、ボットの状態など、プロジェクト固有の型定義
│   │   └── mineflayer-extensions.d.ts # Mineflayerプラグインなどで拡張される型の定義
│   └── models/                     # データモデルの定義（必要であれば）
│       └── BotState.ts             # ボットの状態を表すデータモデル
├── docker/
│   ├── Dockerfile                  # Dockerイメージ構築のための定義ファイル
│   └── docker-compose.yml          # 複数コンテナのオーケストレーション定義ファイル (オプション)
├── tests/                          # テストファイル
├── node_modules/                   # 依存関係
├── .env.example                    # 環境変数の例
├── package.json
├── package-lock.json
├── tsconfig.json                   # TypeScriptコンパイラの設定ファイル
└── README.md

相关 MCP