Skip to main content
Glama

FluffOS MCP Server

by gesslar
GitHub
JavaScript
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

FluffOS MCP Server

Real driver validation for LPC development - An MCP server that wraps FluffOS CLI tools to provide actual driver-level validation and debugging.

This MCP server exposes FluffOS's powerful CLI utilities (symbol and lpcc) to AI assistants, enabling them to validate LPC code against the actual driver and examine compiled bytecode.

What This Enables

āœØ AI assistants can now:

  • Validate LPC files using the actual FluffOS driver (not just syntax checking)

  • Catch runtime compilation issues that static analysis misses

  • Examine compiled bytecode to debug performance or behavior issues

  • Understand how LPC code actually compiles

Tools

  • šŸ” fluffos_validate: Validate an LPC file using FluffOS's symbol tool

  • šŸ”¬ fluffos_disassemble: Disassemble LPC to bytecode using lpcc

Prerequisites

1. FluffOS Installation

You need FluffOS installed with the CLI tools available. The following binaries should exist:

  • symbol - For validating LPC files

  • lpcc - For disassembling to bytecode

2. Node.js

Node.js 16+ required:

node --version # Should be v16.0.0 or higher

3. Install Dependencies

cd /path/to/fluffos-mcp npm install

Configuration

The server requires two environment variables:

  • FLUFFOS_BIN_DIR - Directory containing FluffOS binaries (symbol, lpcc)

  • MUD_RUNTIME_CONFIG - Path to your FluffOS config file (e.g., /mud/lib/etc/config.test)

Setup for Different AI Tools

Warp (Terminal)

Add to your Warp MCP configuration:

Location: Settings ā†’ AI ā†’ Model Context Protocol

{ "fluffos": { "command": "node", "args": ["/absolute/path/to/fluffos-mcp/index.js"], "env": { "FLUFFOS_BIN_DIR": "/path/to/fluffos/bin", "MUD_RUNTIME_CONFIG": "/mud/lib/etc/config.test" } } }

Important: Use absolute paths!

Restart Warp after adding the configuration.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or equivalent:

{ "mcpServers": { "fluffos": { "command": "node", "args": ["/absolute/path/to/fluffos-mcp/index.js"], "env": { "FLUFFOS_BIN_DIR": "/path/to/fluffos/bin", "MUD_RUNTIME_CONFIG": "/mud/lib/etc/config.test" } } } }

Restart Claude Desktop after configuration.

Usage Examples

Once configured, you can ask your AI assistant:

"Validate this LPC file with the actual driver" ā†’ AI uses fluffos_validate to run symbol

"Show me the bytecode for this function" ā†’ AI uses fluffos_disassemble to run lpcc

"Why is this code slow?" ā†’ AI examines the disassembly to identify inefficient patterns

How It Works

AI Assistant ā†“ (natural language) MCP Protocol ā†“ (tool calls: fluffos_validate, fluffos_disassemble) This Server ā†“ (spawns: symbol, lpcc) FluffOS CLI Tools ā†“ (validates/compiles with actual driver) Your LPC Code

  1. AI assistant sends MCP tool requests

  2. Server spawns appropriate FluffOS CLI tool

  3. CLI tool validates/disassembles using the driver

  4. Server returns results to AI

  5. AI understands your code at the driver level!

Complementary Tools

This server works great alongside:

  • lpc-mcp - Language server integration for code intelligence

  • VS Code with jlchmura's LPC extension - IDE support

Use them together for the complete LPC development experience!

Contributing

PRs welcome! This is a simple wrapper that can be extended with more FluffOS tools.

Credits

License

Unlicense - Public Domain. Do whatever you want with this code.

Deploy Server
A
security ā€“ no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Enables AI assistants to validate LPC code and examine compiled bytecode using FluffOS driver tools, providing real driver-level compilation checking and performance analysis for MUD development.

  1. What This Enables
    1. Tools
      1. Prerequisites
        1. 1. FluffOS Installation
        2. 2. Node.js
        3. 3. Install Dependencies
      2. Configuration
        1. Setup for Different AI Tools
          1. Warp (Terminal)
          2. Claude Desktop
        2. Usage Examples
          1. How It Works
            1. Complementary Tools
              1. Contributing
                1. Credits
                  1. License

                    New MCP Servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/gesslar/fluffos-mcp'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server