puzzlebox
Puzzlebox is an MCP server managing finite state machines as dynamic resources, facilitating coordination among multiple agents. It allows clients to create, manage, and subscribe to shared state resources, ensuring coordinated transitions for complex processes like software development.
puzzlebox
Coordinating agents with state machines
An MCP server that hosts finite state machines as dynamic resources that clients can subscribe to and be updated when their state changes.
What problem does puzzlebox address?
Puzzlebox addresses the challenge of coordination among multiple agents working towards a big goal, involving process-aware agents collaborating within distinct project phases, exemplified by enterprise software development processes.
What is a puzzle?
A puzzle is a finite state machine with a finite number of discrete states. It allows for transitions between states through actions and guards that validate these transitions.
What is puzzlebox?
Puzzlebox is an MCP server implementation that supports multiple client connections, managing puzzles and exposing them as dynamic resources clients can subscribe to. It provides tools for adding, managing, and updating puzzles.
MCP Tools
- add_puzzle: Add a new puzzle instance.
- get_puzzle_snapshot: Get the current state and actions of a puzzle.
- perform_action_on_puzzle: Attempt a state transition.
- count_puzzles: Get the count of registered puzzles.
Local Setup
Running locally requires Node and npm. Use npm commands to install dependencies, build, start the server, and perform other development tasks.