mcpbeat Sign in

HeadlessMc MCP Server

by headlesshq Your server? Claim it
local only

HeadlessMc runs on your own machine — the client starts it, so there is no endpoint to ping. 17 installs a week from npm. Last commit 19 Oct 2026.

Install, launch and control Minecraft: Java Edition clients and servers, also headless.

Installs per day peak 17 · avg 0
a month agotoday
17
Installs / week
npm · @headlesshq/headlessmc-mcp
8
Stars
1 open issue
19 Oct 2026
Last commit
3 releases in 90 days
MIT
License
Java

What the code does

We read the source, 5 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

const child = spawn(path, process.argv.slice(2), { stdio: 'inherit', windowsHide: true });

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add headlessmc-mcp -- npx -y @headlesshq/headlessmc-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "headlessmc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@headlesshq/headlessmc-mcp"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.headlessmc-mcp]
command = "npx"
args = ["-y", "@headlesshq/headlessmc-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "headlessmc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@headlesshq/headlessmc-mcp"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "headlessmc-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@headlesshq/headlessmc-mcp"
      ]
    }
  }
}

Alternatives to HeadlessMc

same job, measured the same way
Tabfleet
by tabfleet

Launch, inspect, control, and share isolated cloud browsers for your agents.

answering
Sovrnti MCP
by sovrnti

Headless benchmarks for digital sovereignty, scored on Innovation, Control and Scale.

answering
MCP Mat
by codelipenghui

Headless Eclipse MAT MCP server for Java heap dump analysis

34 installs/wk local only
KeyShot MCP
by truman-t3

Control local KeyShot scenes, cameras, environments, and renders through headless scripting.

145 installs/wk local only
Autocad Site MCP
by blackmoon87

Headless CAD engine & MCP server for 2D/3D drafting, solids, DXF/SVG export, and automation.

151 installs/wk 19 tools answering
Newton Browser
by koala-studios

Local-only Chrome and Edge control for MCP clients through an origin-scoped extension.

20 installs/wk local only
Bind Alias MCP
by prohect

MCP bridge for BindAlias Minecraft mod: game state, screenshots, aliases, and config editing.

12 installs/wk local only
Atelier
by marmikshah

Offline, headless pixel-art editor: draw, animate, inspect, and export sprites and fonts.

local only

HeadlessMc — questions

Answers built from our own checks of this server.

Why is there no uptime for HeadlessMc?
HeadlessMc runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @headlesshq/headlessmc-mcp was installed 17 times last week.
How do I connect HeadlessMc?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls @headlesshq/headlessmc-mcp straight from npm; nothing to host, nothing to sign up for.
How many people use HeadlessMc?
The npm package @headlesshq/headlessmc-mcp was installed 17 times in the last week. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is HeadlessMc open source?
Yes — it is published under the MIT licence, written in Java, 8 stars on GitHub and 1 open issue. The source link is on this page, so you can read exactly what it does with your data before you connect it.