starsinger-mcp

StarSinger MCP 服务

一个 MCP（Model Context Protocol）服务，让 AI Agent 能够访问 StarSinger AI 音乐目录 — 搜索、串流播放并浏览不断扩充的 AI 生成音乐库。

创作歌曲（v0.2）

让你的助手创作一首歌，它就能做到 — make_song 会创作歌词、谱曲并演唱一首完整的歌曲，带有真实人声，大约一分钟即可完成（如果你提出要求，也可以创作纯音乐），歌曲会保存在 API 密钥所关联的 StarSinger 账号中。

• 每天可以免费创作一首歌，无需订阅。免费创作的歌曲会发布到 StarSinger 公共动态 — 工具会告知这一点，并且只有在 publicOk: true 时才会继续。
• 用完免费额度后，需要使用已购买的歌曲点数（发布前为私密）。如果没有剩余点数，工具会提供结账链接和价格。
• song_status 可查询任务状态，my_songs 可列出你最近创作的歌曲，wallet 会告知下一首歌将消耗什么。

远程使用（无需安装）：向 https://mcp-api.starsinger.ai/mcp 发送 POST 请求，并使用 Authorization: Bearer <api key> — Streamable HTTP，无状态。

快速开始

1. 获取 API 密钥

在 mcp.starsinger.ai 免费获取 API 密钥 — 注册后从控制面板创建密钥。

2. 添加到 AI 工具

Claude Desktop — 添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "starsinger": {
      "command": "npx",
      "args": ["-y", "starsinger-mcp"],
      "env": {
        "STARSINGER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor — 添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "starsinger": {
      "command": "npx",
      "args": ["-y", "starsinger-mcp"],
      "env": {
        "STARSINGER_API_KEY": "your_api_key_here"
      }
    }
  }
}

VS Code — 添加到用户设置：

{
  "mcp": {
    "servers": {
      "starsinger": {
        "command": "npx",
        "args": ["-y", "starsinger-mcp"],
        "env": {
          "STARSINGER_API_KEY": "your_api_key_here"
        }
      }
    }
  }
}

3. 试用

向你的 AI 助手提出请求：

“帮我找一些轻松的爵士钢琴曲”

“StarSinger 有哪些艺人？”

“给我找一首适合健身视频的欢快曲目”

工具

search_music

通过自然语言查询、情绪或流派搜索目录。

参数	类型	必填	描述
query	string	是	自然语言搜索 — “欢快的爵士钢琴曲”、“悲伤的小提琴叙事曲”
mood	string	否	按情绪筛选：purple（轻松）、red（充满活力）、blue（感性）、gold（振奋）、green（自然）、pink（浪漫）、dark（强烈）、rainbow（多元）
limit	number	否	返回结果数量（默认 10，最多 50）

get_track

获取指定曲目的完整详情和串流播放 URL。

参数	类型	必填	描述
trackId	string	是	搜索结果中的曲目 ID

get_trending

获取目录中当前热门的曲目。

参数	类型	必填	描述
limit	number	否	曲目数量（默认 10，最多 50）

browse_artists

浏览 AI 目录中的艺人，可按流派筛选。

参数	类型	必填	描述
genre	string	否	按流派筛选（例如 “jazz”、“classical”、“pop”）
limit	number	否	艺人数量（默认 10，最多 50）

get_artist

获取艺人的完整档案和作品目录。

参数	类型	必填	描述
artistId	string	否	浏览结果中的艺人 ID
handle	string	否	艺人账号名（例如 “miles_rivers”）

你将获得

每条曲目响应都包含：

• 串流播放 URL — 可直接播放或嵌入的 MP3 链接
• 封面图 — 专辑封面图片 URL
• 完整歌词 — 完整的歌曲歌词
• 元数据 — 标题、艺人、流派、情绪、播放次数、点赞数
• 艺人信息 — 简介、影响来源、乐器、所在城市

配置

环境变量	必填	默认值	描述
STARSINGER_API_KEY	是	—	你的 StarSinger API 密钥
STARSINGER_API_URL	否	https://mcp-api.starsinger.ai	API 基础 URL

关于 StarSinger

StarSinger 是一个 AI 音乐创作平台。目录中的所有音乐均由 AI 生成，归 Veronata Inc. 所有，并可通过此 API 使用。

许可证

MIT