HeadlessMc MCP server

by headlesshq·io.github.headlesshq/headlessmc-mcp·v0.1.0·8 stars

No reviews yet

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

A94/100grade A

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

A94/100

full report

Adoption

Growing

8 stars67 downloads/wk

Reviews

Write one

Nobody has reviewed HeadlessMc yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

HeadlessMc tools

No tool declarations could be read from the package source. They show once the server is installed.

Public scan report

scanner v0.1.10 · 2026-10-27 · same rubric, same numbers if you re-run it

no findings

Code scan2 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 3 days ago15/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10

Overall 94/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How HeadlessMc compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 94/100; higher than 96% of 48,255 servers
GitHub stars: 8; more than 86% of 28,688 servers
Downloads a week: 67; more than 52% of 12,191 servers with a package

Install HeadlessMc in Claude Code, Cursor or VS Code

Runs npx -y @headlesshq/headlessmc-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add headlessmc-mcp -- npx -y @headlesshq/headlessmc-mcp

Add to Cursor

What the publisher says

From the HeadlessMc repository's README, as published. We do not edit it. Read it on GitHub

HeadlessMc - MCP An MCP server for HeadlessMc: install, launch and control Minecraft: Java Edition from AI agents. HMC | HMC-Specifics | HMC-Skill

[!WARNING]

This is a prototype. We are looking forward to feedback and feature requests.

With this MCP server, Claude Code, Codex, Cursor and other MCP clients can:

each client in its own profile (game directory with its own mods, config and worlds),

install vanilla, Fabric, Forge and NeoForge versions, Java, and mods from Modrinth (everything HeadlessMc can do),
launch several clients and servers at the same time, optionally headless (no display or GPU, e.g. in CI or Docker),

connect to servers, etc.

control running clients: read the screen, click buttons, type, chat, run commands,

read the logs of every instance and send console commands to servers.

Setup

For instructions on HeadlessMc itself (installing it, mod testing in CI with MC-Runtime-Test), install the headlessmc-skill as well.

Tools

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

HeadlessMc: common questions

Is HeadlessMc MCP server safe?: Yes, by our scan: it is graded A (94/100). Read the HeadlessMc safety report
How do I install HeadlessMc?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does HeadlessMc need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is HeadlessMc maintained?: The last commit was 11 days ago (2026-10-24). The latest release is v0.1.0.
How does HeadlessMc compare with other MCP servers?: safety score 94/100 (higher than 96% of 48,255 servers); github stars 8 (more than 86% of 28,688 servers); downloads a week 67 (more than 52% of 12,191 servers with a package). Full comparison.