FluffOS MCP Server

Instructions

Implementation Reference

• src/index.js:90-106 (registration)

  Registration of the fluffos_validate tool, including name, description, and input schema.
  { name: "fluffos_validate", description: "Validate an LPC file using the FluffOS driver's symbol tool. " + "Compiles the file and reports success or failure with any " + "compilation errors. Fast and lightweight check for code validity.", inputSchema: { type: "object", properties: { file: { type: "string", description: "Absolute path to the LPC file to validate", }, }, required: ["file"], }, },
• src/index.js:145-156 (handler)

  Dispatch handler in the CallToolRequestSchema that invokes runSymbol for fluffos_validate.
  case "fluffos_validate": { const result = await this.runSymbol(args.file) return { content: [ { type: "text", text: result, }, ], } }
• src/index.js:205-238 (handler)

  Core handler logic for fluffos_validate: spawns FluffOS 'symbol' tool to compile/validate the LPC file, captures stdout/stderr, and returns success/failure message with output.
  async runSymbol(lpcFile) { return new Promise((resolve, reject) => { const normalizedPath = this.normalizePath(lpcFile) const symbolPath = path.join(this.binDir, "symbol") const proc = spawn(symbolPath, [this.configFile, normalizedPath], { cwd: path.dirname(this.configFile), }) let stdout = "" let stderr = "" proc.stdout.on("data", data => { stdout += data.toString() }) proc.stderr.on("data", data => { stderr += data.toString() }) proc.on("close", code => { const output = (stdout + stderr).trim() if(code === 0) { resolve(`✓ File validated successfully\n\n${output}`) } else { resolve(`✗ Validation failed (exit code: ${code})\n\n${output}`) } }) proc.on("error", err => { reject(new Error(`Failed to run symbol: ${err.message}`)) }) }) }
• src/index.js:72-85 (helper)

  Helper function to normalize LPC file paths by stripping the mudlib directory prefix if applicable, used in runSymbol.
  normalizePath(lpcFile) { // If we have a mudlib directory and the file path is absolute and starts with mudlib dir, // convert it to a relative path if(this.mudlibDir && path.isAbsolute(lpcFile) && lpcFile.startsWith(this.mudlibDir) ) { // Remove mudlib directory prefix and leading slash return lpcFile.substring(this.mudlibDir.length).replace(/^\/+/, "") } // Otherwise return as-is (already relative or not under mudlib) return lpcFile }
• src/index.js:96-105 (schema)

  Input schema definition for the fluffos_validate tool.
  inputSchema: { type: "object", properties: { file: { type: "string", description: "Absolute path to the LPC file to validate", }, }, required: ["file"], },