bitburner-mcp-server

Playmentum/bitburner-mcp-server

3.1

If you are the rightful owner of bitburner-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Model Context Protocol (MCP) server for integrating Claude Desktop with the Bitburner game.

Tools
2
Resources
0
Prompts
0

Bitburner MCP Server

Model Context Protocol (MCP) server for integrating Claude Desktop with the Bitburner game.

What This Does

Allows Claude Desktop to upload and execute arbitrary NetScript code in Bitburner through a file-based task queue system. Features real-time dashboard monitoring and comprehensive safety guidelines.

Architecture

  • Simple API Server (src/simple-api-server.ts) - HTTP API + WebSocket server for Bitburner communication
  • MCP Client (src/simple-mcp-client.ts) - Claude Desktop integration via MCP protocol
  • Task Executor (task-executor.js) - Bitburner script that processes the task queue
  • Dashboard (public/dashboard.html) - Real-time monitoring interface
  • Safety Guide (CLAUDE_INSTRUCTIONS.md) - Critical usage instructions for Claude

How It Works

  1. Claude Desktop calls MCP tools (health_check, upload_and_run_script, etc.)
  2. MCP client uploads scripts to Bitburner via Remote API
  3. Tasks are queued in task_queue.txt file
  4. Task executor (running in Bitburner) processes queue and writes results to task_results.txt
  5. Dashboard shows real-time events via WebSocket

Setup

  1. npm install
  2. Start API server: npm run start:simple-api
  3. In Bitburner: Connect to ws://localhost:12525
  4. In Bitburner: Run task-executor.js
  5. Dashboard: http://localhost:3001/dashboard

Critical Safety

NEVER use these in uploaded scripts:

  • ns.kill() (without specific targets)
  • ns.killall()
  • ns.exit()

They will break the task executor system.