Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

craftos-mcp

by Akkirukversion 0.5.0i★ 0iRuns on your computerRepository ↗
Registry nameio.github.Akkiruk/craftos-mcp

How to install

What it does

CC:Tweaked (ComputerCraft) emulator: run, test and screenshot Lua programs, monitors and turtles.

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Web & browsers

Use together with

Skills that teach the AI this kind of work; they work alongside this one

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

by google-research★ 35,6291 skills

Skill · How-to guide

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

by BigBodyCobain★ 11,6021 skills

Skill · How-to guide

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

by gosom★ 8,2091 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score12/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install craftos-mcp. Follow https://mcp.popnx.com/i/akkiruk-craftos-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 19, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server craftos-mcp for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "craftos": { "command": "npx", "args": [ "-y", "craftos-mcp", "serve" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the craftos-mcp tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  3. Paste these settings and save the file

    {
      "mcpServers": {
        "craftos": {
          "command": "npx",
          "args": [
            "-y",
            "craftos-mcp",
            "serve"
          ]
        }
      }
    }
  4. Quit Claude and open it again

  5. Try it

    Use craftos-mcp and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using craftos-mcp or shows a craftos-mcp tool in the answer, you are connected

3 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • CRAFTOS_WORKSPACE Folder with your Lua project, copied onto every emulated computer (default: the current folder).
  • CRAFTOS_ADDONS Mods to simulate besides CC:Tweaked: all, none, or ids separated by commas such as create,mekanism (vhcctweaks is opt-in: all,vhcctweaks).
  • CRAFTOS_VERSION Minecraft version new computers start on: 1.21.1 (CC:Tweaked 1.121.0, the default), 1.20.1 (CC:Tweaked 1.121.0) or 1.18.2 (CC:Tweaked 1.101.3).

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect craftos-mcp yet

craftos-mcp runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect craftos-mcp

  • Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • Install Node.js on your computer first (one time)
  • Install Node.js on your computer first (one time)
  • Install Node.js on your computer first (one time)

B · Others in Web & browsers that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server craftos-mcp for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user craftos -- npx -y craftos-mcp serve 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the craftos-mcp tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  3. Paste this command and press Enter

    claude mcp add --scope user craftos -- npx -y craftos-mcp serve
  4. Type /mcp in Claude Code

    You should see craftos-mcp listed as connected

  5. Try it

    Use craftos-mcp and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using craftos-mcp or shows a craftos-mcp tool in the answer, you are connected

3 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • CRAFTOS_WORKSPACE Folder with your Lua project, copied onto every emulated computer (default: the current folder).
  • CRAFTOS_ADDONS Mods to simulate besides CC:Tweaked: all, none, or ids separated by commas such as create,mekanism (vhcctweaks is opt-in: all,vhcctweaks).
  • CRAFTOS_VERSION Minecraft version new computers start on: 1.21.1 (CC:Tweaked 1.121.0, the default), 1.20.1 (CC:Tweaked 1.121.0) or 1.18.2 (CC:Tweaked 1.101.3).

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server craftos-mcp for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "craftos": { "command": "npx", "args": [ "-y", "craftos-mcp", "serve" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the craftos-mcp tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  3. Open the AI chat in Cursor in Agent mode

  4. Try it

    Use craftos-mcp and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using craftos-mcp or shows a craftos-mcp tool in the answer, you are connected

3 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • CRAFTOS_WORKSPACE Folder with your Lua project, copied onto every emulated computer (default: the current folder).
  • CRAFTOS_ADDONS Mods to simulate besides CC:Tweaked: all, none, or ids separated by commas such as create,mekanism (vhcctweaks is opt-in: all,vhcctweaks).
  • CRAFTOS_VERSION Minecraft version new computers start on: 1.21.1 (CC:Tweaked 1.121.0, the default), 1.20.1 (CC:Tweaked 1.121.0) or 1.18.2 (CC:Tweaked 1.101.3).

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server craftos-mcp for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "craftos": { "type": "stdio", "command": "npx", "args": [ "-y", "craftos-mcp", "serve" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the craftos-mcp tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  3. Open the AI chat in VS Code in Agent mode

  4. Try it

    Use craftos-mcp and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using craftos-mcp or shows a craftos-mcp tool in the answer, you are connected

3 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • CRAFTOS_WORKSPACE Folder with your Lua project, copied onto every emulated computer (default: the current folder).
  • CRAFTOS_ADDONS Mods to simulate besides CC:Tweaked: all, none, or ids separated by commas such as create,mekanism (vhcctweaks is opt-in: all,vhcctweaks).
  • CRAFTOS_VERSION Minecraft version new computers start on: 1.21.1 (CC:Tweaked 1.121.0, the default), 1.20.1 (CC:Tweaked 1.121.0) or 1.18.2 (CC:Tweaked 1.101.3).

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use craftos-mcp💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user craftos -- npx -y craftos-mcp serve

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "craftos": {
      "command": "npx",
      "args": [
        "-y",
        "craftos-mcp",
        "serve"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "craftos": {
      "command": "npx",
      "args": [
        "-y",
        "craftos-mcp",
        "serve"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "craftos": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "craftos-mcp",
        "serve"
      ]
    }
  }
}

Values you fill in

  • CRAFTOS_WORKSPACE env
    Folder with your Lua project, copied onto every emulated computer (default: the current folder).
  • CRAFTOS_ADDONS env
    Mods to simulate besides CC:Tweaked: all, none, or ids separated by commas such as create,mekanism (vhcctweaks is opt-in: all,vhcctweaks).
  • CRAFTOS_VERSION env
    Minecraft version new computers start on: 1.21.1 (CC:Tweaked 1.121.0, the default), 1.20.1 (CC:Tweaked 1.121.0) or 1.18.2 (CC:Tweaked 1.101.3).

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
Runs on your computer
Latest versioni
0.5.0
Published to registryi
Nov 19, 2026
Code last changedi
Nov 18, 2026
Maker
Akkiruk
Packages
npm: craftos-mcp
Website
github.com
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account Akkiruk, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed yesterday

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

Not checked yet

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/akkiruk-craftos-mcp.svg)](https://mcp.popnx.com/en/servers/akkiruk-craftos-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Web & browsersi

  • More stars than 0% of the other 1613 servers in this category
  • Published to the registry more recently than 99% of the other 1613 servers in this category
  • Basic checks equal to or better than 99% of the other 1613 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is craftos-mcp safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed yesterday, and the latest version (0.5.0) reached the registry today.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Browser Use, changedetection.io (official), Apify MCP Server, Pomerado, Actionbook

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Browser Use

Lets AI do web tasks for you, such as filling forms, searching and extracting data, in the maker’s cloud browsers or on your computer.

by browser-useWidely used↓ 1.7M/wk★ 121.4KUpdated 29 days ago

Computer or cloud✓ service owner · browser-use.com

Apify MCP Server

Extract data from any website with thousands of scrapers, crawlers, and automations on Apify Store ⚡

by apifyWidely used★ 16.9KUpdated 2 days ago

Runs in the cloud✓ service owner · apify.com

Pomerado

Connect your agents to any website. The cheaper, faster and more reliable alternative to browser use

by PomeradoGrowing★ 1.8KUpdated yesterday

Runs in the cloud✓ service owner · pomerado.ai

Actionbook

Let your AI agent operate any website through a real, logged-in browser session.

by actionbookGrowing★ 1.6KUpdated 31 days ago

Runs in the cloud✓ service owner · actionbook.app
Compared with similar ones
This one
craftos-mcp
Browser Usechangedetection.io (official)Apify MCP ServerPomeradoActionbook
Runs whereInstalls on your computerCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoYesNoYesNoNo
Add with + in ClaudeNoYesNoNoNoNo
Basic checks3/35/53/34/44/44/4
LicenseMITMITApache-2.0MITMITApache-2.0
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

craftos-mcp

Run and test your ComputerCraft programs without starting Minecraft. craftos-mcp is a CC:Tweaked emulator for people who write CC Lua: computers, monitors you can tap, turtles that dig and build in a block world, rednet between several computers, and blocks from Create, Mekanism, Advanced Peripherals and more. Pause the clock, jump a day ahead, save the whole world and put it back. Write tests for your programs and run them with one command. It works by hand, like CraftOS-PC, and an AI coding agent can drive it too (below).

The ROM is built from the real CC:Tweaked jar, and the engine passes 1189 of 1190 of CC:Tweaked's own tests at 1.101.3 (and 1361 of 1362 at 1.121.0). 58 of the community's libraries, programs and operating systems, from Basalt and Pine3D to Opus, LevelOS and Phoenix, install and run in it as they do in the game: the list. How exact is it says, area by area, what was measured in game and what was written from source.

Some games built and tested with it are [playable in your browser](https://rogiedoji.com/craftos), no install.

Start in a minute

The app: download it and press Run

No Node.js and no terminal. Get the file for your computer from the latest release:

Your computerDownloadThen
Windows 10 or 11CraftOS- -windows-x64-setup.exeRun it. It installs for you alone (no admin rights) and puts CraftOS in the Start menu. If Windows says it does not know the app: More info, Run anyway.
Mac, Apple silicon (M1 on)CraftOS- -macos-arm64.dmgOpen it and drag CraftOS onto Applications. For the first start, see the note below.
Mac, IntelCraftOS- -macos-x64.dmgThe same.
Linux, any distributionCraftOS- -linux-x64.AppImagechmod +x CraftOS-*.AppImage, then run it.
Linux, Debian, Ubuntu or MintCraftOS- -linux-x64.debsudo apt install ./CraftOS-*.deb, then CraftOS is in your applications menu.

First start on a Mac: the app is not signed with a paid Apple developer id, so macOS stops it once. Right-click (or Control-click) CraftOS in Applications, choose Open, then Open again. On macOS 15 and newer: open it once and dismiss the warning, then go to System Settings, Privacy & Security, find "CraftOS was blocked" near the bottom and click Open Anyway. After that it opens like any app.

CraftOS opens on its home screen. Open a folder that holds your Lua programs (or New project for a folder with a first program and a first test), pick your Minecraft version, tick the mods your modpack has, and press Run: the computer opens in the window, with its monitors, the world around it and its files. Run tests runs every *.test.lua in the folder. Your choices are kept in craftos.json in that folder, which the command line and an AI agent read too. The first Run downloads CC:Tweaked's own files from its official page, once (under a minute); they cannot ship inside the app. More in the desktop app guide.

With npm

You need Node.js 22 or newer, on Windows x64, Linux x64, or macOS 11+ (Apple silicon or Intel). Run these from a terminal in the folder with your Lua files. That folder is the computer's disk.

npx craftos-mcp window                    # the computer in a desktop window, like CraftOS-PC

npx craftos-mcp window --monitor top:3x2 # with a monitor on top, 3 blocks wide and 2 high, in its own window npx craftos-mcp app # computers, monitors, turtles and the world side by side in your browser npx craftos-mcp run door.lua # run one program and print what the screen showed npx craftos-mcp test # every *.test.lua below here; exits 1 on a failure

The first one gets the engine and builds the CC:Tweaked ROM of your Minecraft version, once, in about a minute; it says so in four short lines (craftos-mcp setup --verbose shows every step). npm install -g craftos-mcp once and you can leave out npx.

A short tour

Each step is one small program. Getting started has every file in full.

  • Run a program. Put hello.lua in your folder and run npx craftos-mcp run hello.lua: it prints what the screen showed. In the window or the app, type hello at the prompt.
  • A monitor. npx craftos-mcp run sign.lua --monitor top:3x2 gives the computer a monitor 3 blocks wide and 2 high, and prints the monitor's text too. A world file (`{"monitors": [{"name": "top", "blocksWide": 3, "blocksHigh":

2}]}`) keeps it there.

  • A button. In the app (npx craftos-mcp app), + New computer with a monitor, run your program, and click the monitor: a click is a player's tap, a monitor_touch event. UI shows each button and where it starts.
  • Test it. lamp.test.lua runs the program, taps the button with ccunit.touch("top", 4, 4) and checks the monitor says Lamp is ON. npx craftos-mcp test --monitor top:2x1 prints PASS lamp.test.lua (2 tests).
  • Rednet between two computers. In the app set Computers to 2: each gets a wireless modem and a tab. One runs rednet.receive(), the other rednet.broadcast(...), and the Network view shows each message go across.
  • A turtle that builds. Give a turtle a world with ground, fuel and a stack of blocks, and watch it build in the Blocks view in 3D (the picture at the top). npx craftos-mcp run tower.lua --world tower.world.json --timescale 5 runs it on the command line, five times faster than the game.
  • A block from a mod. Advanced Peripherals' player detector, a Create station or a Mekanism reactor is one line in a world file. Move a player in the World panel and a door program opens for them. Switch on only the mods your pack has.
  • Pause and jump time. The bar along the bottom of the app pauses every computer, steps one tick, runs 2 to 10 times faster, or jumps a minute, an hour or a Minecraft day ahead, so a sleep(600) is over in a click.
  • Snapshots. Save the whole world under a name, change things, and Restore puts it back. Export gives you a .craftos-world file to share.

The guide

docs/guide has a page for each part: getting started, the desktop app, the browser app, the window, worlds and world files, testing with ccunit, mods, time and snapshots, coming from CraftOS-PC and troubleshooting.

Use it with an AI agent

AI agents write CC:Tweaked Lua they have never run, and the bugs turn up on your server. craftos-mcp lets the agent test its code itself over MCP: it runs the program, reads the terminal and every monitor, taps buttons, changes the world around the computer (a player walks up, a chest fills, a train arrives, a reactor heats up, an hour passes), writes and runs tests, and fixes what broke until it works.

_A real Claude Code session, unscripted: asked for a door controller with tests, it ran its program in the emulator, caught a monitor that never stopped redrawing and a player at the range edge who could not get in, fixed both, and finished with its tests passing. Then the same file went onto a computer in real Minecraft and worked there with no code changes, just a player name added to its whitelist (the diff, the clip). The full transcript is next to the video._

The server needs Node.js 22 or newer. Its first start downloads the engine and builds the CC:Tweaked ROM by itself, once (a minute or so); the server answers straight away and the tools that run computers wait for it. The computers' files are the folder the server starts in. While an agent works, you can watch and help in the live viewer at http://127.0.0.1:7878, which is the browser app.

Claude Code
claude mcp add craftos -- npx -y craftos-mcp serve                 # Linux, WSL

claude mcp add craftos -- cmd /c npx -y craftos-mcp serve # Windows (native)

Or install the plugin, which adds the cc-tweaked-dev skill too:

/plugin marketplace add Akkiruk/craftos-mcp

/plugin install craftos-mcp@craftos-mcp

The plugin's first start runs the setup in the background (a few minutes). If /mcp shows the server as failed on that first try, wait a minute and reconnect. Progress is in .cache/setup.log inside the plugin's folder.

VS Code with Copilot

Install the extension (also on Open VSX). It gives Copilot's agent mode the server, adds Run in CraftOS for any .lua file, and lists your *.test.lua files in the Testing view. Without the extension, put this in .vscode/mcp.json:

{

"servers": { "craftos": { "type": "stdio", "command": "npx", "args": ["-y", "craftos-mcp", "serve"] } } }

Cursor

Cursor has no MCP API for extensions, so the server goes in .cursor/mcp.json in your project (or ~/.cursor/mcp.json for every project). The extension offers to write it for you, in Cursor and in Windsurf, or add it yourself:

{

"mcpServers": { "craftos": { "command": "npx", "args": ["-y", "craftos-mcp", "serve"] } } }

The extension also gives Cursor Run in CraftOS and the Testing view.

Windsurf, Claude Desktop, Codex and others

The same mcpServers entry as Cursor goes in Windsurf's ~/.codeium/windsurf/mcp_config.json and Claude Desktop's claude_desktop_config.json. Codex takes it in ~/.codex/config.toml:

[mcp_servers.craftos]

command = "npx" args = ["-y", "craftos-mcp", "serve"]

Any other MCP client: run npx -y craftos-mcp serve over stdio. On Windows, if a client cannot start npx, give it cmd with the arguments /c npx -y craftos-mcp serve.

Your agent's first program and test

Ask your agent

Only the beginning is shown; read the rest in the repo