Skip to main content
Glama
rodcordeiro

mine_mcp

by rodcordeiro
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

mine_mcp

CI License: MIT

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)

Variável

Default

Função

MINE_MCP_DATA_DIR

<repo>/data

Pasta com points.json e recipes.json

MINE_MCP_DOWNLOADS_DIR

<repo>/downloads

Sandbox de downloads exaroton

EXAROTON_API_TOKEN

—

Obrigatório para tools exaroton

EXAROTON_SERVER_ID

—

Servidor padrão (opcional)

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

Script

Ação

pnpm run check

typecheck + test

pnpm run typecheck

tipos sem emit

pnpm run test

Jest (inclui e2e stdio)

pnpm run build

gera dist/ (prebuild roda check)

pnpm run dev

tsx src/index.ts

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Minestom MCP Server

    RonaldBunk
    A
    license
    A
    quality
    C
    maintenance
    An MCP server designed for developers to build and manage Minestom-based Minecraft servers by inspecting project environments, build configurations, and API documentation. It enables users to plan features, review design patterns, and discover libraries within the Minestom ecosystem.
    9
    4 npm
    6
    Apache 2.0

  • Minecraft Ops MCP

    damocjwj
    A
    license
    B
    quality
    D
    maintenance
    An MCP server for managing and operating Minecraft servers through multiple backend protocols including MCSManager API, RCON, and MSMP. It provides tools for instance lifecycle management, file operations, console commands, player administration, and server configuration with built-in security controls.
    71
    2
    MIT