Skip to main content
Glama
deenesjakoruzh
mattlack15

Minecraft Command Execution MCP Server

by mattlack15
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Minecraft 명령어 실행 MCP 서버

Claude가 MasterControl API를 통해 Minecraft 명령어를 실행하고 탭 완성을 가져올 수 있도록 하는 MCP(Model Context Protocol) 서버입니다.

기능

이 MCP 서버는 두 가지 도구를 제공합니다:

1. execute_command

인증된 플레이어로서 원격으로 Minecraft 명령어를 실행합니다.

  • 플레이어는 온라인 상태여야 하며 서버에 접속해 있어야 합니다.

  • 명령어가 실행되면 플레이어는 게임 내 알림을 받습니다.

  • 명령어 출력 또는 오류 메시지를 반환합니다.

  • 도움말 보기: 명령어 뒤에 "help"를 붙이세요 (예: "island help", "island upgrade help")

예시:

execute_command("gamemode creative")
execute_command("island help")              # Shows island command help
execute_command("island upgrade help")      # Shows upgrade subcommand help
execute_command("island upgrade speed 5")

2. tab_complete

부분적인 명령어에 대한 탭 완성 제안을 가져옵니다.

  • 사용 가능한 명령어 및 하위 명령어 탐색

  • 유효한 인수 및 매개변수 찾기

  • Minecraft에서 Tab 키를 누르는 것과 정확히 동일하게 작동합니다.

예시:

tab_complete("gamemode ")   # Returns: survival, creative, adventure, spectator
tab_complete("island ")     # Returns: available island subcommands

Related MCP server: MCP Minecraft Remote

사전 요구 사항

  • Python 3.10 이상

  • uv 패키지 관리자 (여기서 설치)

  • 명령어 API가 실행 중인 MasterControl 서버

  • Minecraft 플레이어를 위한 유효한 API 키

설치

  1. 저장소 복제:

git clone https://github.com/<your-user>/minecraft-mcp-server.git
cd minecraft-mcp-server

  1. 의존성 설치:

uv sync

  1. 환경 변수 구성:

cp .env.example .env

  1. 설정으로 .env 편집:

# Required: Your Midnight API key
MIDNIGHT_API_KEY=your-api-key-here

# Optional: MasterControl API URL (defaults to localhost:8080)
MIDNIGHT_API_URL=http://your-server:8080/api/v2

사용법

로컬 테스트

서버를 직접 실행하여 테스트합니다:

uv run server.py

stdio 입력을 기다리게 되며, 이는 MCP 서버에서 정상적인 동작입니다. 종료하려면 Ctrl+C를 누르세요.

Claude Code와 통합

Claude Code에 서버를 추가합니다 (복제된 저장소의 절대 경로를 사용하세요):

claude mcp add midnight \
  --transport stdio \
  --env MIDNIGHT_API_KEY=your-key-here \
  --env MIDNIGHT_API_URL=http://localhost:8080/api/v2 \
  -- uv --directory /absolute/path/to/minecraft-mcp-server run server.py

설치 확인

Claude Code에서 서버가 실행 중인지 확인합니다:

/mcp

midnight가 상태 ✓ Connected로 나열되어야 합니다.

대화 예시

명령어 실행:

You: "Change my gamemode to creative"
Claude: [Uses execute_command("gamemode creative")]
        ✓ Command executed successfully

명령어 도움말 보기:

You: "How do I use the island upgrade command?"
Claude: [Uses execute_command("island upgrade help")]
        Shows the help output for island upgrade

명령어 탐색:

You: "What island commands are available?"
Claude: [Uses tab_complete("island ")]
        Lists: upgrade, create, delete, invite, members...

구성

환경 변수

변수

필수

기본값

설명

MIDNIGHT_API_KEY

예

-

플레이어의 API 키

MIDNIGHT_API_URL

아니오

http://localhost:8080/api/v2

MasterControl API 기본 URL

API 엔드포인트

  • POST /api/v2/command/execute — 명령어 실행

  • POST /api/v2/command/tabComplete — 탭 완성 가져오기

문제 해결

"MIDNIGHT_API_KEY environment variable not set!"

.env 파일을 생성하세요:

echo "MIDNIGHT_API_KEY=your-key-here" > .env

"Failed to execute command"

다음 사항을 확인하세요:

  1. MasterControl API가 실행 중인지

  2. API 키가 올바른지

  3. 플레이어가 온라인 상태이며 서버에 접속해 있는지 (프록시 대기 상태가 아님)

보안

  • .env 파일을 절대 커밋하지 마세요 — API 키가 포함되어 있습니다 (.gitignore를 통해 이미 제외됨)

  • 명령어는 플레이어의 권한으로 실행됩니다

  • AI는 사용자가 게임 내에서 실행할 수 있는 모든 명령어를 실행할 수 있습니다

Install Server
F
license - not found
A
quality
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Remote Desktop Commander

    Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer

  • mcp

    Augments MCP Server - A comprehensive framework documentation provider for Claude Code

  • LLMemory

    Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mattlack15/midnightsky-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server