@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