English Français العربية

io.github.starsinger-ai/starsinger-mcp

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

MCP server for StarSinger AI music catalog — search, stream & browse AI-generated tracks

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

التثبيت

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

NPM package starsinger-mcp
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
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "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>"
            }
        }
    }
}

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

  • STARSINGER_API_KEY إلزامي سري Your StarSinger API key from https://mcp.starsinger.ai
  • STARSINGER_API_URL Optional: Custom API base URL (default: https://mcp-api.starsinger.ai)

التوثيق

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

المحتويات
  1. StarSinger MCP Server
  2. Quick Start
  3. Tools
  4. What You Get
  5. Configuration
  6. About StarSinger
  7. 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.

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

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

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

MCP server for StarSinger AI music catalog — search, stream & browse AI-generated tracks

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

يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

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

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

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

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

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

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

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