247afk

This MCP server is designed to bridge your AI assistants with the 247afk block editor scripts in real time. It runs locally and exposes a WebSocket bridge at 127.0.0.1:3002 so that MCP clients (such as Claude, Codex, Gemini, Cursor, and other MCP-compatible tools) can connect and perform script edits, updates, and manipulations directly on the 247afk editor in your browser. Once started, open a script in the 247afk editor; your AI assistant can then issue MCP commands to modify nodes, variables, and the overall graph, with changes reflected in the editor in real time. This setup enables automated editing workflows and collaborative scripting with live feedback.

To use the server, install the MCP package, run it locally, and connect your MCP client configuration to the provided server name (247afk-mcp). The README examples show how to register the server with various clients and how to start a simple test session that opens an inspector UI for manual tool invocation. When connected, your AI assistant can leverage the server’s capabilities to update node data, move nodes, validate graphs, save scripts, and more, all through the MCP protocol.

Prerequisites:

• Node.js 18 or later
• npm (comes with Node.js)

Install the MCP server globally:

npm install -g 247afk-mcp

Verify installation (optional):

247afk-mcp --version

Run the MCP server (example):

247afk-mcp

Register the server with your MCP clients as shown in README examples (Claude, Codex, Gemini, Cursor). For example, in a client configuration:

{
  "mcpServers": {
    "247afk-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "247afk-mcp"
      ]
    }
  }
}

If you prefer to start via npx directly (without a global install), you can use:

npx -y 247afk-mcp

Tips and known considerations:

• The MCP WebSocket bridge runs on 127.0.0.1:3002; ensure this port is accessible from your MCP clients.
• The server relies on the 247afk editor being the target script editor; ensure you have a script open in the editor to apply changes in real time.
• When using npx, the package will be fetched and executed on demand; for offline or repeated runs, consider installing globally as shown.
• If you encounter connectivity issues, verify your firewall allows localhost:3002 and that there are no conflicting WebSocket servers on the same port.
• If you update the 247afk editor or MCP client, restart both the server and client to ensure compatibility.
• Environment variables: currently none are required by default; you may add future environment-specific settings as needed (e.g., custom host/port) by extending the mcpServers configuration.
• Node.js prerequisites and browser requirements are defined in the README: Node.js 18+ and access to 247afk’s script editor.