home / mcp / fluffos mcp server

FluffOS MCP Server

MCP server for FluffOS driver tools - validate and disassemble LPC code

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "gesslar-fluffos-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@gesslar/fluffos-mcp"
      ],
      "env": {
        "FLUFFOS_BIN_DIR": "/path/to/fluffos/bin",
        "FLUFFOS_DOCS_DIR": "/path/to/fluffos/docs",
        "MUD_RUNTIME_CONFIG_FILE": "/mud/lib/etc/config.test"
      }
    }
  }
}

You run a FluffOS MCP Server that exposes the FluffOS CLI tools to your AI assistants, enabling real driver-level LPC validation, disassembly, and documentation lookups. This makes it possible to validate code against the actual driver, inspect compiled bytecode, and understand how LPC code compiles and behaves in practice.

How to use

Ask your MCP-enabled AI assistant to perform actions that validate, disassemble, or look up documentation for LPC code. Use phrases like “Validate this LPC file with the actual driver” to run a driver-backed validation, or “Show me the bytecode for this function” to view the disassembly. You can also request targeted documentation lookups for efuns, applies, and concepts to deepen your understanding of the language and its runtime semantics.

How to install

Prerequisites you need before you install this MCP server:

Node.js 16 or newer is required
A FluffOS installation with the CLI tools available (symbol and lpcc)

Install the MCP server globally using npm or install it locally by cloning the repository and installing dependencies.

npm install -g @gesslar/fluffos-mcp
```
```bash
# Or clone and install locally
git clone https://github.com/gesslar/fluffos-mcp.git
cd fluffos-mcp
npm install

Configuration and usage notes

Configure environment variables to point to your FluffOS binaries, config, and optional docs for quick doc lookups.

{
  "fluffos": {
    "type": "stdio",
    "name": "fluffos_npm",
    "command": "npx",
    "args": ["-y", "@gesslar/fluffos-mcp"],
    "env": {
      "FLUFFOS_BIN_DIR": "/path/to/fluffos/bin",
      "MUD_RUNTIME_CONFIG_FILE": "/mud/lib/etc/config.test",
      "FLUFFOS_DOCS_DIR": "/path/to/fluffos/docs"
    }
  }
}

If you prefer running from a local clone, use this alternative command configuration.

{
  "fluffos": {
    "type": "stdio",
    "name": "fluffos_local",
    "command": "node",
    "args": ["/absolute/path/to/fluffos-mcp/index.js"],
    "env": {
      "FLUFFOS_BIN_DIR": "/path/to/fluffos/bin",
      "MUD_RUNTIME_CONFIG_FILE": "/mud/lib/etc/config.test",
      "FLUFFOS_DOCS_DIR": "/path/to/fluffos/docs"
    }
  }
}

Additional content

Tools exposed by this MCP server include validation, disassembly, and documentation lookup.

Available tools

fluffos_validate

Validate an LPC file by launching FluffOS's symbol tool against your config and file, returning success or compilation errors.

fluffos_disassemble

Disassemble LPC to bytecode by running FluffOS's lpcc against your config and file, returning complete bytecode details including function tables and strings.

fluffos_doc_lookup

Search FluffOS documentation for efuns, applies, concepts, and related topics to aid understanding.