starsinger-mcp

StarSinger MCP 服务

一个 MCP（Model Context Protocol）服务，可让 AI Agent 访问 StarSinger AI 音乐目录——在不断扩充的 AI 生成音乐库中搜索、播放和浏览曲目。

快速开始

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	否	按流派筛选（例如 “爵士”、“古典”、“流行”）
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