Sonic Pi MCP

🚀 Declarative Sonic Pi MCP

A Model Context Protocol (MCP) server that allows AI assistants to interact with Sonic Pi via OSC messages. This enables AI tools like Claude and Cursor to create, modify, and delete Sonic Pi projects.

✨ Features

• Declarative Syntax: Define project structures in a simple and clear way.
• Dynamic Editing: Edit projects in real - time without manual intervention.
• Version Control: Automatically save and track the change history of projects.
• Scalability: Support the integration of multiple tools and workflows.

📦 Installation

Prerequisites

1. Install Node.js.
2. Install Yarn.
3. Install Bun.

Project Structure

your-project/
├── package.json
├── yarn.lock
└── tsconfig.json

Install Dependencies

yarn install

Start the Application

bun run dev

💻 Usage Examples

Overview of Features

• Create Projects: Quickly create new projects using declarative syntax.
• Edit Projects: Dynamically modify the structure and content of existing projects in real - time.
• Version Control: Track all modifications to the project through the change history.

Integration Guide

1. Install dependencies in the project root directory:

yarn install

2. Start the development server:

bun run dev

3. Create a new project using declarative syntax:

{
  "name": "my-project",
  "description": "This is a sample project.",
  "tools": {
    "code-editor": {
      "language": "javascript"
    }
  }
}

4. Edit the structure and content of an existing project.
5. View the change history and restore previous versions.

Tool Usage Examples

Create a New Project

{
  "name": "my-project",
  "description": "This is a sample project.",
  "tools": {
    "code-editor": {
      "language": "javascript"
    }
  }
}

Edit an Existing Project

1. Open the project and enter edit mode.
2. Modify the project content using declarative syntax.

🤝 Contribution Guidelines

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add some amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Submit a Pull Request.

📄 License

This project is licensed under the MIT License.