faust-mcp-magda

MCP server that gives AI assistants access to the Faust DSP compiler and standard library. Built as a companion tool for MAGDA.

The Faust compiler runs entirely in-process via WebAssembly — no external Faust installation required.

Configure

Add to your MCP client config (e.g. .claude/settings.json, mcp.json, or Claude Desktop config):

{
  "mcpServers": {
    "faust-mcp-magda": {
      "command": "npx",
      "args": ["faust-mcp-magda"]
    }
  }
}

No install step needed — npx fetches and caches the package automatically.

Tools

compile_faust

Compile Faust DSP code and get structured metadata (parameters, I/O count, UI layout) on success, or compilation errors on failure.

{ "code": "process = +;", "name": "MyDSP", "args": ["-vec"] }

search_faust_libraries

Search the Faust standard library for functions by name or keyword.

{ "query": "lowpass", "limit": 5 }

get_faust_library

Read the source of a Faust standard library file.

{ "library": "filters" }

list_faust_libraries

List all available Faust standard libraries.

Resources

faust://magda-conventions

MAGDA-specific Faust conventions: parameter metadata annotations ([idx:N], [unit:Hz], [scale:log], [style:menu{...}]), the 64-slot parameter pool, and I/O conventions.

Development

npm run dev    # run with tsx (no build step)
npm run build  # compile TypeScript
npm start      # run compiled server