@glassbead/mcp-audius

Configuration

Configure the MCP server in your client's settings:

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-audius": {
      "command": "npx",
      "args": ["@glassbead/mcp-audius"],
      "env": {
        "AUDIUS_API_KEY": "your-api-key"
      }
    }
  }
}

VSCode

Add to your MCP settings file:

{
  "mcpServers": {
    "mcp-audius": {
      "command": "npx",
      "args": ["@glassbead/mcp-audius"],
      "env": {
        "AUDIUS_API_KEY": "your-api-key"
      }
    }
  }
}

Environment Variables

Copy .env.example to .env.local and configure:

cp .env.example .env.local

Required:

• AUDIUS_API_KEY: Your Audius API key (obtain from Audius)

Features

Track Operations

• Search tracks with filtering and sorting
• Get track details and metadata
• Stream tracks with efficient caching
• Manage track favorites
• Access track comments
• Get trending tracks with pagination

User Operations

• Get user profiles and details
• Search for users
• Follow/unfollow functionality
• View user's tracks, favorites, and reposts
• Get user followers and following
• Access trending users

Playlist & Album Management

• Access playlist details and tracks
• View album information
• Get trending playlists
• Manage playlist favorites

Performance Features

• Efficient LRU caching system for stream URLs
• Automatic cache cleanup and monitoring
• Connection tracking and rate limiting
• Graceful shutdown support

Performance Considerations

Batch Request Limits

⚠️ Important: Requesting more than 10 tracks or playlists at once may result in extended wait times. For optimal performance:

• Limit batch requests to 10 or fewer items
• Utilize pagination for larger datasets
• Consider using the caching system for frequently accessed content

Caching Behavior

The server implements an LRU (Least Recently Used) cache for stream URLs with:

• Automatic TTL-based expiration
• Memory usage optimization
• Built-in monitoring and statistics

Streaming Server

• Default port: 3333 (configurable)
• Rate limiting: 60 requests/minute
• Range request support for seeking
• Proper CORS configuration

Development

Building from Source

git clone https://github.com/glassBead-tc/audius-mcp.git
cd audius-mcp
npm install
npm run build

Running Tests

npm test

Documentation

• CHANGELOG.md - Detailed version history and changes
• CONTRIBUTING.md - Guidelines for contributing

Version Information

Current version: 1.3.3

Notable changes in recent versions:

• Added performance warning prompts
• Improved streaming reliability
• Enhanced caching system
• Removed blockchain/financial features to focus on core music experience

License

MIT