本ライブラリは、Minecraft Game Skills と MCP Integration のクライアントライブラリです。

Fairies MCP Client ( ) は、ワンクリックで直接接続することもできます。

##特徴

-Minecraft Control:AIエージェントをMinecraftサーバーに接続し、ボットを制御する

• ** 30 検証スキル**: 既定の, 一般的な Minecraft タスクのためのテストされたスキル
• 柔軟な接続:任意のMinecraftサーバーに接続し、任意のボット構成 -マルチボットサポート: 複数のボットを同時に管理 -MCP標準:任意のMCPクライアント(デスクトップクローデなど)と互換性があります。

インストール

##npx による直接呼び出し(推奨)

##npm経由(推奨)

ソースから

使用法

サーバーの起動

デフォルト接続設定でMCPサーバーを起動できます。

コマンドラインオプション

##Claude デスクトップまたは JSON 構成との統合

macOSのClaudeデスクトップ設定(~/Library/Application Support/Claude/claude_desktop_config.json)に追加します。

リモートインストール(推奨)

ソースからローカルで実行する場合:

リポジトリをクローンした実際のパスで[/path/to/minecraft-mcpを置換します。

他のMCPクライアントとの###統合

Fundamental Labs/Minecraft Client

This library is the Client library for a Minecraft Game Skills and MCP Integration.

Fairies MCP Client () also supports direct connection with a single click.

Features

• Full Minecraft Control: Connect AI agents to Minecraft servers and control bots
• 30 Verified Skills: Pre-built, tested skills for common Minecraft tasks
• Flexible Connection: Connect to any Minecraft server with optional per-bot configuration
• Multi-Bot Support: Manage multiple bots simultaneously
• MCP Standard: Compatible with any MCP client (Claude Desktop, etc.)

Installation

Direct call via npx (Recommended)

npx --y -- @fundamentallabs/minecraft-mcp

Via npm (Recommended)

npm install -g @fundamentallabs/minecraft-mcp

From Source

git clone https://github.com/FundamentalLabs/minecraft-mcp.git
cd minecraft-mcp/minecraft-client/mcp-server
npm install
npm run build

Usage

Starting the Server

You can start the MCP server with optional default connection settings:

# Start with no defaults (connection specified per bot)
minecraft-mcp

# Start with default connection settings
minecraft-mcp -h play.example.com -p 25565

Command Line Options

Options:
  -p, --port   Minecraft server port (default: 25565)
  -h, --host   Minecraft server host (default: localhost)
  --help            Display help

Integration with Claude Desktop or JSON configurations Locally

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

For remote installation (recommended)

{
  "mcpServers": {
    "minecraft": {
      "command": "npx",
      "args": ["-y", "-- @fundamentallabs/minecraft-mcp"]
    }
  }
}

If running locally from source:

{
  "mcpServers": {
    "minecraft": {
      "command": "node",
      "args": ["/path/to/minecraft-mcp/minecraft-client/mcp-server/dist/mcp-server.js"]
    }
  }
}

Replace /path/to/minecraft-mcp with the actual path where you cloned the repository.

Integration with Other MCP Clients

The server uses stdio transport and can be integrated with any MCP client:

# Using the MCP inspector for testing
cd minecraft-client/mcp-server
npx @modelcontextprotocol/inspector node dist/mcp-server.js -- -p 25565

Available Skills

Bot Management

• joinGame - Spawn a new bot into the Minecraft game

  • username (required): Bot’s username
  • host (optional): Server host (defaults to ‘localhost’ or command line option)
  • port (optional): Server port (defaults to 25565 or command line option)

• leaveGame - Disconnect bot(s) from the game

  • username (optional): Specific bot to disconnect
  • disconnectAll (optional): Disconnect all bots if true

Movement & Navigation

• goToSomeone - Navigate to another player