이 라이브러리는 Minecraft Game Skills 및 MCP 통합을 위한 클라이언트 라이브러리입니다.

Fairies MCP Client ( )는 단일 클릭으로 직접 연결을 지원합니다.

특징

-Full Minecraft Control: Minecraft 서버에 AI 에이전트를 연결하고 봇을 제어합니다. -30 Verified Skills: 사전 제작, 일반적인 Minecraft 작업에 대한 테스트 기술

• Flexible Connection: 옵션 per-bot 구성으로 Minecraft 서버에 연결
• Multi-Bot 지원: 여러 봇을 동시에 관리
• MCP Standard: 모든 MCP 클라이언트와 호환 (Claude Desktop 등)

설치

npx (추천)를 통해 직접 통화

npm (추천)

출처에서

사용법

서버 시작

옵션 기본 연결 설정으로 MCP 서버를 시작할 수 있습니다.

명령 선 선택권

Claude Desktop 또는 JSON 구성과 통합 로컬

macOS에서 Claude 데스크톱 구성 (~/Library/Application Support/Claude/claude_desktop_config.json]에 추가하십시오.

원격 설치(recommended)

소스에서 로컬로 실행하는 경우:

/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