Filopastry

Filopastry is an MCP server that lets AI agents generate, manipulate, and perform algorithmic music through Strudel.cc by automating a browser-based live coding environment. It exposes a suite of pattern generation, music theory, analysis, and AI-powered tools that you can orchestrate from any MCP client to create and perform music in real time.

How to use

Connect Filopastry to your MCP client and start issuing tools to build, control, and analyze patterns in Strudel.cc. Begin with initializing the Strudel environment, then progressively write, modify, and play patterns. Use the AI-powered tools to describe or refine what you want to hear, and rely on the audio analysis tools to observe spectrum, tempo, and key in real time. Save and load your patterns to organize your sessions, and use undo/redo to manage edits.

A practical workflow looks like this: initialize the Strudel session, generate or write a pattern, start playback, and analyze the output. Save the current pattern with metadata for future recall, then load a different pattern or apply variations. If you have an API key for AI generation, enable the AI tools to create or enhance patterns from natural language prompts. When working offline, you can fall back to the built-in pattern generator to produce static patterns.

How to install

Prerequisites you need on your system before installing Filopastry: Node.js 18.0.0 or higher, npm 9.0.0 or higher, and Chromium (installed automatically by Playwright). Ensure your environment can run npm and npx commands.

Step-by-step installation:

How to install

# Clone the repository
git clone https://github.com/youwenshao/filopastry.git
cd filopastry

# Install dependencies
npm install

# Install Playwright browsers (Chromium)
npx playwright install chromium

# Build the project
npm run build

Available tools

init

Initialize Strudel in the browser to prepare the editing environment.

write

Write pattern code to the Strudel editor.

append

Append code to the current pattern in the editor.

insert

Insert code at a specific line within the pattern.

replace

Replace a section of the current pattern.

play

Start playback of the current pattern.

pause

Pause playback of the current pattern.

stop

Stop playback and reset playback state.

clear

Clear the editor content.

get_pattern

Retrieve the current pattern code from the editor.

generate_pattern

Generate a complete pattern from a chosen style (techno, house, dnb, ambient, trap, jungle, jazz).

generate_drums

Generate a drum pattern.

generate_bassline

Generate a bassline for the current pattern.

generate_melody

Generate a melody based on a selected scale.

generate_scale

Generate a set of scale notes.

generate_chord_progression

Generate a chord progression.

generate_euclidean

Generate an Euclidean rhythm.

generate_polyrhythm

Generate a polyrhythm.

generate_fill

Generate a drum fill.

generate_variation

Create pattern variations.

transpose

Transpose notes by semitones.

reverse

Reverse the current pattern.

stretch

Time-stretch the pattern.

quantize

Quantize notes to the grid.

humanize

Add human timing variation to notes.

apply_scale

Apply a musical scale to notes.

add_effect

Add an effect to the pattern.

remove_effect

Remove an effect from the pattern.

set_tempo

Set the BPM for the pattern.

add_swing

Add swing to the pattern.

validate_pattern_runtime

Validate the pattern with runtime error checking.

analyze

Perform complete audio analysis of the current pattern.

analyze_spectrum

Perform FFT spectrum analysis.

analyze_rhythm

Analyze rhythm characteristics.

detect_tempo

Detect BPM of the current pattern.

detect_key

Detect the key of the current pattern.

save

Save the current pattern with metadata.

load

Load a saved pattern.

list

List saved patterns.

undo

Undo the last action.

redo

Redo the last undone action.

ai_generate_pattern

Generate a pattern from natural language using AI.

ai_enhance_pattern

Enhance or modify the current pattern with AI.

ai_explain_pattern

Explain what the current pattern does.

ai_analyze_pattern

Analyze style, complexity, and provide suggestions.

ai_suggest_variations

Generate AI-suggested pattern variations.

ai_status

Check if DeepSeek AI is configured.

ai_test_connection

Test the DeepSeek API connection.

performance_report

Get performance metrics and potential bottlenecks.

memory_usage

Get current memory usage statistics.