mine_mcp

Servidor MCP TypeScript (stdio) independente para:

• pontos de mapa Minecraft (coordenadas X/Z);

• receitas e guias (farm, build, potion, etc.);

• inspeção/download de arquivos e mundos via API REST exaroton.

Requisitos

• Node.js 20+

• pnpm

pnpm install
pnpm run build

Related MCP server: Minestom MCP Server

Configuração (env do client MCP)

Se recipes.json não existir em MINE_MCP_DATA_DIR, o servidor copia o seed empacotado data/recipes.seed.json. Edite o arquivo no data/ do client para incrementar/alterar receitas.

Exemplo de MCP client:

{
  "mcpServers": {
    "mine_mcp": {
      "command": "node",
      "args": ["C:/path/to/minecraft_mcp/dist/index.js"],
      "env": {
        "MINE_MCP_DATA_DIR": "C:/path/to/user-data"
      }
    }
  }
}

Scripts

Estrutura

• src/index.ts — MCP server, resources e tools

• src/config.ts — paths via env

• src/services/ — regras

• src/repository/ — persistência JSON

• data/recipes.seed.json — seed de receitas

• skills/mine-mcp/ — skill do agente

• plugins/codex/mine-mcp/ — plugin Codex (skill + MCP)

• plugins/cursor/mine-mcp/ — plugin Cursor (skill + MCP)

• docs/backlog.md — backlog

Resources

• mine-mcp://workspace/context — paths efetivos

• mine-mcp://integrations/exaroton — estado da integração (sem token)

Tools

Mapa: register_point, list_points, distance_to_point, nearest_point_by_type
Receitas: register_recipe, list_recipes, get_recipe
exaroton: exaroton_get_account, exaroton_list_servers, exaroton_get_server, exaroton_get_server_ram, exaroton_get_file_info, exaroton_get_text_file, exaroton_download_file, exaroton_download_directory, exaroton_download_world

Detalhes de parâmetros e casos de uso: skills/mine-mcp/SKILL.md.

Segurança

• Não committe tokens.

• Downloads restritos a MINE_MCP_DOWNLOADS_DIR.

• stdout é JSON-RPC; logs em stderr.

CI

GitHub Actions (.github/workflows/ci.yml): install → typecheck → test → build em Node 20.

Versão

0.2.0 — servidor independente, data/ via env, seed de receitas, skill e plugins Codex/Cursor.

Comunidade

• Contributing

• Code of Conduct

• Security Policy

• License (MIT)

• Backlog