English Français العربية

ai.starsinger/starsinger-mcp

السجل الرسمي البحث والويب

Make a finished AI song with real vocals from a brief, or search and stream StarSinger's AI catalog

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http starsinger-mcp 'https://mcp-api.starsinger.ai/mcp' --header 'Authorization: <Bearer <your StarSinger API key from https://mcp.starsinger.ai>>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "starsinger-mcp": {
            "type": "http",
            "url": "https://mcp-api.starsinger.ai/mcp",
            "headers": {
                "Authorization": "<Bearer <your StarSinger API key from https://mcp.starsinger.ai>>"
            }
        }
    }
}
NPM package starsinger-mcp
Claude Code 
claude mcp add starsinger-mcp -e 'STARSINGER_API_KEY=<your starsinger_api_key>' -- npx -y starsinger-mcp@0.2.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "starsinger-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "starsinger-mcp@0.2.1"
            ],
            "env": {
                "STARSINGER_API_KEY": "<your starsinger_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • STARSINGER_API_KEY إلزامي سري Your StarSinger API key from https://mcp.starsinger.ai

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. StarSinger MCP Server
  2. Make a song (v0.2)
  3. Quick Start
  4. Tools
  5. What You Get
  6. Configuration
  7. About StarSinger
  8. License

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.

Make a song (v0.2)

Ask your assistant to make a song and it can — make_song writes the lyrics, composes and sings a finished song with real vocals in about a minute (or an instrumental if you ask), on the StarSinger account behind your API key.

  • One free song a day, no subscription. A free song is published to the public StarSinger feed — the tool says so and only proceeds with publicOk: true.
  • After that, a purchased song credit (private until you publish). With none left, the tool hands back a checkout link and the price.
  • song_status polls a job, my_songs lists your recent songs, wallet says what the next song will spend.

Remote (no install): POST https://mcp-api.starsinger.ai/mcp with Authorization: Bearer <api key> — Streamable HTTP, stateless.

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.

ParameterTypeRequiredDescription
querystringYesNatural language search — "upbeat jazz piano", "sad violin ballad"
moodstringNoFilter by mood: purple (chill), red (energetic), blue (emotional), gold (uplifting), green (nature), pink (romantic), dark (intense), rainbow (eclectic)
limitnumberNoResults to return (default 10, max 50)
get_track

Get full details and streaming URL for a specific track.

ParameterTypeRequiredDescription
trackIdstringYesTrack ID from search results

Get currently popular tracks from the catalog.

ParameterTypeRequiredDescription
limitnumberNoNumber of tracks (default 10, max 50)
browse_artists

Browse AI catalog artists, optionally filtered by genre.

ParameterTypeRequiredDescription
genrestringNoFilter by genre (e.g. "jazz", "classical", "pop")
limitnumberNoNumber of artists (default 10, max 50)
get_artist

Get an artist's full profile and discography.

ParameterTypeRequiredDescription
artistIdstringNoArtist ID from browse results
handlestringNoArtist 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 VariableRequiredDefaultDescription
STARSINGER_API_KEYYes—Your StarSinger API key
STARSINGER_API_URLNohttps://mcp-api.starsinger.aiAPI 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

الأسئلة الشائعة

ما هو ai.starsinger/starsinger-mcp؟

Make a finished AI song with real vocals from a brief, or search and stream StarSinger's AI catalog

كيف أثبّت ai.starsinger/starsinger-mcp؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http starsinger-mcp 'https://mcp-api.starsinger.ai/mcp' --header 'Authorization: <Bearer <your StarSinger API key from https://mcp.starsinger.ai>>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج ai.starsinger/starsinger-mcp إلى مفتاح API؟

نعم. يتطلب STARSINGER_API_KEY, Authorization، وتضبطها في إعداداته.

هل ai.starsinger/starsinger-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون ai.starsinger/starsinger-mcp؟

ينشره jupiterspins. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.