feat: initialize minecraft-aiworld Claude Code workspace
Configure mc-ai-bridge MCP server at 10.0.0.247:3002 for AI-driven Minecraft Bedrock interaction with all 6 tools documented. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
12
.gitignore
vendored
Normal file
12
.gitignore
vendored
Normal file
@@ -0,0 +1,12 @@
|
||||
# OS
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
|
||||
# Editor
|
||||
.vscode/
|
||||
.idea/
|
||||
*.swp
|
||||
*.swo
|
||||
|
||||
# Claude Code
|
||||
.claude/
|
||||
7
.mcp.json
Normal file
7
.mcp.json
Normal file
@@ -0,0 +1,7 @@
|
||||
{
|
||||
"mcpServers": {
|
||||
"minecraft": {
|
||||
"url": "http://10.0.0.247:3002/mcp"
|
||||
}
|
||||
}
|
||||
}
|
||||
50
CLAUDE.md
Normal file
50
CLAUDE.md
Normal file
@@ -0,0 +1,50 @@
|
||||
# Minecraft AI World
|
||||
|
||||
This is a Claude Code workspace for interacting with a Minecraft Bedrock world via the mc-ai-bridge MCP server.
|
||||
|
||||
## Connection
|
||||
|
||||
The mc-ai-bridge runs at `10.0.0.247`:
|
||||
- **WebSocket** (Minecraft → Bridge): port `3001`
|
||||
- **MCP HTTP** (Claude → Bridge): port `3002`
|
||||
|
||||
To connect Minecraft Bedrock to the bridge, run this command in-game:
|
||||
```
|
||||
/connect 10.0.0.247:3001
|
||||
```
|
||||
|
||||
## Available MCP Tools
|
||||
|
||||
### `minecraft_command`
|
||||
Execute any slash command in Minecraft. Do NOT include the leading `/`.
|
||||
- `command` (string): e.g. `"give @p diamond 64"`, `"tp @p 100 64 200"`, `"time set night"`
|
||||
|
||||
### `minecraft_chat`
|
||||
Send a chat message visible in Minecraft.
|
||||
- `message` (string): The message to send
|
||||
- `player` (string, optional): Target player for `/tell`. Omit to broadcast with `/say`.
|
||||
|
||||
### `minecraft_build`
|
||||
Execute a batch of build commands with rate limiting. Max 200 commands per call. Only `setblock`, `fill`, `clone`, and `structure` commands are allowed.
|
||||
- `commands` (string[]): e.g. `["setblock 10 64 10 stone", "fill 10 64 10 20 64 20 glass"]`
|
||||
|
||||
### `minecraft_get_events`
|
||||
Get recent game events from the in-memory event buffer.
|
||||
- `count` (number, optional): Number of events to return (default 20, max 100)
|
||||
- `type` (string, optional): Filter by event type, e.g. `"PlayerMessage"`, `"BlockChanged"`
|
||||
|
||||
### `minecraft_get_status`
|
||||
Check if Minecraft is connected and get status info (player name, uptime, subscriptions, queue stats). No parameters.
|
||||
|
||||
### `minecraft_subscribe`
|
||||
Subscribe to Bedrock event types. Available events:
|
||||
`PlayerMessage`, `BlockChanged`, `PlayerTransform`, `ItemUsed`, `ItemAcquired`, `ItemCrafted`, `MobKilled`, `MobInteracted`, `PlayerTravelled`, `PlayerDied`, `BossKilled`
|
||||
|
||||
- `event` (string): Event type to subscribe to
|
||||
|
||||
## Tips
|
||||
|
||||
- Always call `minecraft_get_status` first to verify Minecraft is connected before issuing commands.
|
||||
- Subscribe to `PlayerMessage` to receive chat from the player.
|
||||
- Use `minecraft_build` for multi-block constructions — it handles rate limiting automatically.
|
||||
- Coordinates in Minecraft are (X, Y, Z) where Y is vertical height.
|
||||
Reference in New Issue
Block a user