Audius MCP Server
by glassBead-tc
@glassbead/mcp-audius
Configuration
Configure the MCP server in your client's settings:
Claude Desktop
Add to claude_desktop_config.json
:
Copy
VSCode
Add to your MCP settings file:
Copy
Environment Variables
Copy .env.example
to .env.local
and configure:
Copy
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
Copy
Running Tests
Copy
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
This server cannot be installed
Enables interaction with the Audius music platform API, supporting user, track, and playlist operations through the Model Context Protocol.