New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Minecraft Debug MCP

by moeru-ai in moeru-ai/airi

Operate and debug the live Minecraft bot through its built-in MCP REPL server.

MITAuto-check passedAgent Workflows

Install Minecraft Debug MCP

skills CLI
$ npx skills add moeru-ai/airi --skill minecraft-debug-mcp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install moeru-ai/airi minecraft-debug-mcp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/moeru-ai/airi.git skills-src && mkdir -p .claude/skills && cp -r skills-src/integrations/minecraft/codex-skills/minecraft-debug-mcp .claude/skills/minecraft-debug-mcp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
minecraft-debug-mcp
GitHub stars
50k
Token cost
~1.1k tokens
SKILL.md length
504 words
Files
3 (incl. references)
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

Operate and debug the live Minecraft bot through its built-in MCP REPL server.

  • Works in 5 steps: Run pnpm dev from… → Wait for MCP REPL server running at… → Connect MCP client to… → …
  • Work requires starting the bot with pnpm dev
  • SKILL.md covers Overview, Quick Start Workflow, Execution Rules and Tooling Strategy, plus 2 more sections
  • Calls pnpm

What it does

Minecraft Debug MCP is an agent skill from moeru-ai/airi. Operate and debug the live Minecraft bot through its built-in MCP REPL server. Use when work requires starting the bot with pnpm dev, connecting to the local MCP endpoint, inspecting cognitive state/logs/history, injecting synthetic chat/events, or running targeted REPL code against the running brain during investigation and development.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/mcp-surface.md`).

It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol and pnpm. The repository describes itself as: 💖🧸 Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-sama's altitude. Capable of… The licence is MIT.

When your agent uses it

  • Work requires starting the bot with pnpm dev
  • Connecting to the local MCP endpoint
  • Inspecting cognitive state/logs/history
  • Injecting synthetic chat/events

Example prompts

  • “/minecraft-debug-mcp”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Run pnpm dev from /path/to/project/root/integrations/minecraft and keep it running.
  2. Wait for MCP REPL server running at http://localhost:3001 in logs.
  3. Connect MCP client to http://localhost:3001/sse.
  4. Verify readiness with a read-only call
  5. Continue with the smallest tool/action that answers the task.

What it can do on your machine

Read from SKILL.md and the folder at commit 45b8670. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Minecraft Debug MCP loads about 1.1k tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 90 tokens; SKILL.md has 504 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~90
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from moeru-ai/airi at commit 45b8670, republished under its MIT licence (© moeru-ai). 504 words, ~1,136 tokens.

Download SKILL.mdSave it as .claude/skills/minecraft-debug-mcp/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
minecraft-debug-mcp
description
Operate and debug the live Minecraft bot through its built-in MCP REPL server. Use when work requires starting the bot with `pnpm dev`, connecting to the local MCP endpoint, inspecting cognitive state/logs/history, injecting synthetic chat/events, or running targeted REPL code against the running brain during investigation and development.

Minecraft Debug MCP

Overview

Use this skill to run the local bot and interact with its MCP debug interface safely and quickly.

Quick Start Workflow

  1. Run pnpm dev from /path/to/project/root/integrations/minecraft and keep it running.
  2. Wait for MCP REPL server running at http://localhost:3001 in logs.
  3. Connect MCP client to http://localhost:3001/sse.
  4. Verify readiness with a read-only call:
    • Read resource brain://state, or
    • Call tool get_state.
  5. Continue with the smallest tool/action that answers the task.

Execution Rules

  • Start read-only, then escalate to mutation tools only when needed.
  • Prefer get_state, get_last_prompt, and get_logs for diagnostics before execute_repl.
  • Prefer get_llm_trace for structured per-attempt reasoning/content inspection.
  • Keep execute_repl snippets minimal and reversible.
  • Use inject_chat for conversational simulation and inject_event only when specific event-shape testing is required.
  • Treat inject_chat as side-effectful: it can trigger actual in-game bot replies/actions.
  • If MCP connection fails, check that pnpm dev is still running and port 3001 is free.

Tooling Strategy

  • Use get_state to inspect queue/processing state and available tools/actions (skips REPL builtins by default; pass { includeBuiltins: true } to include them).
  • Use get_logs with a small limit first.
  • Use get_last_prompt to inspect latest LLM input.
  • Use execute_repl for deep object inspection or one-off targeted calls on the running brain.
  • Use inject_chat to simulate player chat and verify behavior loop.
  • Use get_llm_trace to assert REPL behavior in automation (for example, detect repeated await skip() on specific events).
  • Use execute_repl("forget_conversation()") to clear conversation memory before prompt-engineering tests.

Read references/mcp-surface.md for exact tool/resource names and argument schemas.

Show full SKILL.md (258 more words)Show less

Live-Tested Notes

  • get_state returns available tools/actions and runtime state (skips REPL builtins like skip, use, log by default to reduce noise; pass { includeBuiltins: true } if you need to inspect them).
  • get_last_prompt can return very large payloads; call only when prompt-level debugging is needed.
  • execute_repl returns a structured result where returnValue is stringified; parse mentally as display output, not typed JSON.
  • get_logs(limit=10) is enough to verify whether an injected event reached REPL/executor.
  • get_llm_trace(limit, turnId?) gives structured attempt-level trace data (messages, content, reasoning, usage, duration).
  • get_last_prompt and get_llm_trace are compacted for MCP: system prompt/system-role messages are omitted to reduce token cost.
  • Prefer compact value reads in REPL:
    • query.self() for bot status.
    • query.inventory().has(name, n) / query.inventory().count(name) for checks.
    • query.inventory().summary() for stable aggregated item output.
    • query.snapshot(range?) for one-shot world+inventory capture.
  • forget_conversation() is available as a runtime function in REPL/global context and clears only conversation memory.
  • Current prompt behavior supports two-turn value-first flows: read/query turn returns concrete data first, follow-up turn performs chat/action using that returned value.

Live Testing Workflow

  1. Confirm MCP health:
    • Call get_state.
  2. Capture baseline inventory:
    • execute_repl with query.inventory().list().map(i => ({ name: i.name, count: i.count })).
  3. Trigger a task through normal cognition path:
    • Call inject_chat with a clear instruction (example: "please gather 3 dirt blocks").
  4. Verify execution trace:
    • Call get_logs(limit=10) and check for:
      • bot acknowledgement chat
      • action tool feedback (for example collectBlocks)
      • REPL result summary
    • Call get_llm_trace(limit=5) when you need exact model output/reasoning for assertions.
  5. Re-check inventory using the same REPL snippet and compare against baseline.

Use this workflow when validating behavior changes, tool wiring, or regressions in planning/execution loops.

© moeru-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in integrations/minecraft/codex-skills/minecraft-debug-mcp of moeru-ai/airi.

  • SKILL.md
  • agents/openai.yaml
  • references/mcp-surface.md

Open the folder on GitHubat commit 45b8670

Compare with similar skills

Minecraft Debug MCP next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Minecraft Debug MCP compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Minecraft Debug MCP this skillmoeru-ai/airi50k—~1.1kAutomated safety check: PassMIT
Devcontainer Devstacklok/toolhive-studio170—~3.8kAutomated safety check: NotesApache-2.0
Build And Profilingpikax/verter112—~4.3kAutomated safety check: PassMIT
MCP Security Auditgithub/awesome-copilot40k—~3.1kAutomated safety check: PassMIT
Nx Monorepoaiskillstore/marketplace430—~2kAutomated safety check: PassNone
ReleaseWebMCP-org/npm-packages103—~1.6kAutomated safety check: NotesMIT

Similar skills

  • Devcontainer Dev

    stacklok/toolhive-studio

    Spin up and interact with ToolHive Studio's containerized dev environment (Xvfb + noVNC + DinD).

    170 GitHub stars~3.8k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes

  • Build And Profiling

    pikax/verter

    Build dependency chains, rebuild sequences, profiling with MCP, and Analysis MCP server setup for Verter

    112 GitHub stars~4.3k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • MCP Security Audit

    github/awesome-copilot

    Official

    Audit MCP (Model Context Protocol) server configurations for security issues.

    40k GitHub stars~3.1k tokensUpdated today
    SecurityAuto-check passed

  • Nx Monorepo

    aiskillstore/marketplace

    Nx monorepo management skill for AI-native development. An agent skill from aiskillstore/marketplace.

    430 GitHub stars~2k tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Release

    WebMCP-org/npm-packages

    Release the @mcp-b monorepo with Changesets and pnpm, using npm trusted publishing in GitHub Actions.

    103 GitHub stars~1.6k tokensUpdated 4 days ago
    DevelopmentAuto-check: notes

  • Security Vuln Remediation

    stacklok/toolhive-studio

    Remediate security vulnerabilities found by Grype or pnpm audit.

    170 GitHub stars~2.3k tokensUpdated yesterday
    SecurityAuto-check: notes

More from moeru-ai/airi

All 24 skills in this repo

  • Simple English

    moeru-ai/airi

    Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous, and free of AI slop.

    50k GitHub starsUsed in 2 repos~4.6k tokens
    Auto-check passed

  • Enforce Rules For I18n

    moeru-ai/airi

    Review pending AIRI translations on Crowdin in a batch, then sync them into the repository.

    50k GitHub stars~1.5k tokensUpdated today
    Auto-check passed

  • Upload GitHub Attachment

    moeru-ai/airi

    Upload a local image or file to GitHub's user-attachments storage and return a URL suitable for issue, pull request, discussion, or comment Markdown.

    50k GitHub stars~554 tokensUpdated today
    Auto-check passed

  • Create PR

    moeru-ai/airi

    Prepare and create an AIRI pull request with verifiable change context, architecture evidence, and required visual evidence.

    50k GitHub stars~2.3k tokensUpdated today
    Auto-check passed

  • Use Agent Browser For Airi

    moeru-ai/airi

    Test AIRI display-model imports with agent-browser across stage-tamagotchi Electron, stage-web, and stage-pocket mobile web layouts.

    50k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Agent Browser Electron

    moeru-ai/airi

    A skill your agent uses when Codex needs to inspect, debug, or automate an Electron app through agent-browser and Chrome DevTools Protocol, especially when the app has multiple BrowserWindow…

    50k GitHub stars~3.1k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Minecraft Debug MCP

What does Minecraft Debug MCP do?

Operate and debug the live Minecraft bot through its built-in MCP REPL server. Minecraft Debug MCP is an agent skill from moeru-ai/airi. Operate and debug the live Minecraft bot through its built-in MCP REPL server.

When should I use Minecraft Debug MCP?

Minecraft Debug MCP fits situations like: work requires starting the bot with pnpm dev; connecting to the local MCP endpoint; inspecting cognitive state/logs/history; injecting synthetic chat/events.

How do I install Minecraft Debug MCP in Claude Code?

Run `npx skills add moeru-ai/airi --skill minecraft-debug-mcp -a claude-code`. Or copy the skill folder (integrations/minecraft/codex-skills/minecraft-debug-mcp in moeru-ai/airi) into .claude/skills/minecraft-debug-mcp in your project. Claude Code loads it when a task matches its description.

How do I install Minecraft Debug MCP in Codex?

Run `npx skills add moeru-ai/airi --skill minecraft-debug-mcp -a codex`. Or copy the skill folder (integrations/minecraft/codex-skills/minecraft-debug-mcp in moeru-ai/airi) into .agents/skills/minecraft-debug-mcp in your project. Codex loads it when a task matches its description.

Can I use Minecraft Debug MCP in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add moeru-ai/airi --skill minecraft-debug-mcp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/minecraft-debug-mcp, .gemini/skills/minecraft-debug-mcp, .github/skills/minecraft-debug-mcp and .opencode/skills/minecraft-debug-mcp in your project.

What does Minecraft Debug MCP need to run?

Going by SKILL.md and its folder, Minecraft Debug MCP needs the command-line tools its instructions call (pnpm).

Does Minecraft Debug MCP access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Minecraft Debug MCP safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Minecraft Debug MCP use?

Minecraft Debug MCP is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Minecraft Debug MCP use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.2k tokens, read only when the agent opens those files.

What are the alternatives to Minecraft Debug MCP?

Skills that share tags, products or a category with Minecraft Debug MCP: Devcontainer Dev (stacklok/toolhive-studio, 170 stars), Build And Profiling (pikax/verter, 112 stars), MCP Security Audit (github/awesome-copilot, 40k stars) and Nx Monorepo (aiskillstore/marketplace, 430 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Minecraft Debug MCP?

moeru-ai (a GitHub organization) maintains it in moeru-ai/airi, which has 50,142 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 8, 2026.

Source: moeru-ai/airi on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.