In-Game TrapOS, AI, MCP Guide

Follow this order while playing.

1. Install TrapOS

On the ComputerCraft computer:

wget run https://raw.githubusercontent.com/guillaumearm/cc-libs/next/install-ccpm.lua --beta
ccpm update
ccpm install trapos

If the computer asks to reboot, reboot it.

On your real machine:

opencode serve --hostname 0.0.0.0 --port 4242

If exposing beyond your machine, use a password:

OPENCODE_SERVER_PASSWORD=secret opencode serve --hostname 0.0.0.0 --port 4242

On the ComputerCraft computer, use your public host:

set opencc.server_url http://<public-host>:4242

If you set a password:

set opencc.password secret

Optional model settings:

set opencc.provider_id anthropic
set opencc.model_id claude-opus-4-7

Test it:

ai ping
ai "say hello from TrapOS"

Expected ping: pong.

From this repository on your real machine:

cd tools/mcp-bridge
npm install
CC_LINK_PORT=4243 npm run dev

Production ports:

MCP endpoint: http://127.0.0.1:3000
ComputerCraft link: ws://<public-host>:4243

On the ComputerCraft computer:

mcp-computer ws://<public-host>:4243

Leave it running. You should see:

linked as <id> (Label: <label>)
waiting for requests... Press Ctrl+T to stop.

Add the bridge as an MCP HTTP server in your OpenCode MCP config, pointing at:

http://127.0.0.1:3000

Then ask OpenCode to use the MCP tool probe-computers. A working link returns a pong from <id> line.

ai says missing opencc.server_url: run the set opencc.server_url ... command again.
ai cannot reach server: check opencode serve, public host, port 4242, and ComputerCraft HTTP rules.
mcp-computer says WebSocket unavailable: enable ComputerCraft HTTP/WebSocket support.
MCP sees no computers: keep mcp-computer ws://<public-host>:4243 running in-game.