Audius MCP Server

🚀 Music Creative Platform (Atrium) Development Guide

The Music Creative Platform (Atrium) is a comprehensive music creation and distribution platform based on the Model Context Protocol (MCP). It offers a full - suite solution from music production, content publishing to user interaction and revenue management.

🚀 Quick Start

Prerequisites

• Node.js (version 14.0 or higher is recommended)
• npm (Node Package Manager)
• Audius SDK

Installation Steps

# Clone the project repository
git clone git@github.com:yourusername/atrium.git
cd atrium

# Install dependencies
npm install

Configuration

Edit the src/config.ts file and fill in the following configurations according to your actual situation:

export interface Config {
  // Audius network node address
  AUDIUS_NODE_URL: string;
  
  // Default user ID
  DEFAULT_USER_ID: string;

  // API request timeout (seconds)
  REQUEST_TIMEOUT: number;

  // Whether to enable debug mode
  DEBUG_MODE: boolean;
}

// Example configuration
const config = {
  AUDIUS_NODE_URL: 'https://api.audiusprotocol.com',
  DEFAULT_USER_ID: '123456789',
  REQUEST_TIMEOUT: 30,
  DEBUG_MODE: true
};

✨ Features

Core Features

Music Creation Tools

• Provide multi - track recording and mixing functions.
• Support VST plugin loading.
• Include a MIDI editor and effects manager.

Content Publishing System

• Support multiple content formats (MP3, WAV, FLAC).
• Provide an intelligent cover generation tool.
• Integrate the Audius protocol for distribution.

User Interaction Module

• Follow and fan management system.
• Like and favorite functions.
• Comment management interface.

💻 Usage Examples

Basic Usage

// Initialize the platform instance
const atrium = new Atrium({
  userId: '123456789',
  nodeUrl: 'https://api.audiusprotocol.com'
});

// Get user information
async function getUserInfo() {
  try {
    const response = await atrium.sdkClient.getUserProfile();
    console.log('User profile:', response);
  } catch (error) {
    console.error('Failed to get user profile:', error.message);
  }
}

// Create a new music track
async function createTrack() {
  try {
    const trackData = {
      title: 'My New Track',
      genre: 'Electronic Music',
      description: 'This is my first electronic music creation'
    };
    const response = await atrium.trackManagement.createTrack(trackData);
    console.log('Track created successfully. Track ID:', response.trackId);
  } catch (error) {
    console.error('Failed to create track:', error.message);
  }
}

Advanced Usage

// Distribute music to the Audius network
async function distributeTrack(trackId: string, audioUrl: string) {
  try {
    const response = await atrium.distribution.publishTrack({
      trackId,
      audioUrl,
      metadata: { 
        tags: ['Electronic Music', 'Original'],
        license: 'CC BY - NC - SA'
      }
    });
    console.log('Track distributed successfully. Track URL:', response.url);
  } catch (error) {
    console.error('Failed to distribute track:', error.message);
  }
}

🔧 Technical Details

Project Directory Structure

atrium/
├── src/          # Source code
│   ├── config.ts         # Configuration management
│   ├── server.ts        # Back - end service entry
│   └── services/       # Business logic modules
├── public/         # Front - end resources
└── package.json    # Dependency management

Core Components

• MCP Server: Implements the Model Context Protocol and handles the context information of music content.
• SDK Client: Connects to the Audius protocol network and is responsible for API calls and data interaction.
• Creation Toolset: Includes functional modules such as recording, mixing, and editing.

Testing

# Start the development server
npm run dev

# Run unit tests
npm test

# Execute end - to - end tests
npm run e2e

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for detailed information.

For further information or to participate in development, please visit our official documentation.