io.github.starsinger-ai/starsinger-mcp
MCP server for StarSinger AI music catalog — search, stream & browse AI-generated tracks
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
starsinger-mcpclaude mcp add starsinger-mcp -e 'STARSINGER_API_KEY=<your starsinger_api_key>' -e 'STARSINGER_API_URL=<STARSINGER_API_URL>' -- npx -y starsinger-mcp@0.1.1
{
"mcpServers": {
"starsinger-mcp": {
"command": "npx",
"args": [
"-y",
"starsinger-mcp@0.1.1"
],
"env": {
"STARSINGER_API_KEY": "<your starsinger_api_key>",
"STARSINGER_API_URL": "<STARSINGER_API_URL>"
}
}
}
}
Variables d'environnement
STARSINGER_API_KEYobligatoire secret Your StarSinger API key from https://mcp.starsinger.aiSTARSINGER_API_URLOptional: Custom API base URL (default: https://mcp-api.starsinger.ai)
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
StarSinger MCP Server
An MCP (Model Context Protocol) server that gives AI agents access to the StarSinger AI music catalog — search, stream, and browse tracks from a growing library of AI-generated music.
Quick Start
1. Get an API Key
Get a free API key at mcp.starsinger.ai — sign up and create a key from the dashboard.
2. Add to Your AI Tool
Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"starsinger": {
"command": "npx",
"args": ["-y", "starsinger-mcp"],
"env": {
"STARSINGER_API_KEY": "your_api_key_here"
}
}
}
}
Cursor — add to .cursor/mcp.json:
{
"mcpServers": {
"starsinger": {
"command": "npx",
"args": ["-y", "starsinger-mcp"],
"env": {
"STARSINGER_API_KEY": "your_api_key_here"
}
}
}
}
VS Code — add to user settings:
{
"mcp": {
"servers": {
"starsinger": {
"command": "npx",
"args": ["-y", "starsinger-mcp"],
"env": {
"STARSINGER_API_KEY": "your_api_key_here"
}
}
}
}
}
3. Try It
Ask your AI assistant:
"Find me some chill jazz piano tracks"
"What artists does StarSinger have?"
"Get me an upbeat track for a workout video"
Tools
search_music
Search the catalog by natural language query, mood, or genre.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Natural language search — "upbeat jazz piano", "sad violin ballad" |
mood | string | No | Filter by mood: purple (chill), red (energetic), blue (emotional), gold (uplifting), green (nature), pink (romantic), dark (intense), rainbow (eclectic) |
limit | number | No | Results to return (default 10, max 50) |
get_track
Get full details and streaming URL for a specific track.
| Parameter | Type | Required | Description |
|---|---|---|---|
trackId | string | Yes | Track ID from search results |
get_trending
Get currently popular tracks from the catalog.
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Number of tracks (default 10, max 50) |
browse_artists
Browse AI catalog artists, optionally filtered by genre.
| Parameter | Type | Required | Description |
|---|---|---|---|
genre | string | No | Filter by genre (e.g. "jazz", "classical", "pop") |
limit | number | No | Number of artists (default 10, max 50) |
get_artist
Get an artist's full profile and discography.
| Parameter | Type | Required | Description |
|---|---|---|---|
artistId | string | No | Artist ID from browse results |
handle | string | No | Artist handle (e.g. "miles_rivers") |
What You Get
Every track response includes:
- Streaming URL — Direct MP3 link, ready to play or embed
- Cover art — Album artwork URL
- Full lyrics — Complete song lyrics
- Metadata — Title, artist, genre, mood, play count, likes
- Artist info — Bio, influences, instrument, city
Configuration
| Environment Variable | Required | Default | Description |
|---|---|---|---|
STARSINGER_API_KEY | Yes | — | Your StarSinger API key |
STARSINGER_API_URL | No | https://mcp-api.starsinger.ai | API base URL |
About StarSinger
StarSinger is an AI music creation platform. All music in the catalog is AI-generated and owned by Veronata Inc., available for use via this API.
License
MIT
Questions fréquentes
Qu'est-ce que io.github.starsinger-ai/starsinger-mcp ?
MCP server for StarSinger AI music catalog — search, stream & browse AI-generated tracks
Comment installer io.github.starsinger-ai/starsinger-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add starsinger-mcp -e 'STARSINGER_API_KEY=<your starsinger_api_key>' -e 'STARSINGER_API_URL=<STARSINGER_API_URL>' -- npx -y starsinger-mcp@0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.starsinger-ai/starsinger-mcp ?
Oui. Il attend STARSINGER_API_KEY, à renseigner dans sa configuration.
io.github.starsinger-ai/starsinger-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.starsinger-ai/starsinger-mcp ?
Il est publié par starsinger-ai. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.