MCP Servers

qq-music-mcp

Integrates QQ Music API with MCP, enabling LLMs to search music, retrieve song details, lyrics, and playback URLs.

README

QQ Music MCP Server

一个基于 MCP (Model Context Protocol) 的 QQ 音乐 API 服务器，让大语言模型能够搜索音乐、获取歌曲信息、歌词和播放链接。

安装

# 使用 pip
pip install qq-music-mcp

# 或使用 uv
uv pip install qq-music-mcp

在 Claude Desktop 中使用

编辑 Claude Desktop 配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %AppData%\Claude\claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "qq-music": {
      "command": "uvx",
      "args": ["qq-music-mcp"]
    }
  }
}

或者如果使用 pip 安装：

{
  "mcpServers": {
    "qq-music": {
      "command": "qq-music-mcp"
    }
  }
}

然后重启 Claude Desktop。

功能

提供以下 MCP Tools：

Tool 名称	描述
`search_music`	搜索歌曲、专辑、歌单等
`get_song_detail`	获取歌曲详情
`get_song_quality`	获取歌曲可用音质
`get_lyric`	获取歌词
`get_song_url`	获取单首歌曲播放链接
`get_batch_song_urls`	批量获取歌曲播放链接
`get_album_detail`	获取专辑详情
`get_album_songs`	获取专辑歌曲列表
`get_playlist_detail`	获取歌单详情
`get_album_cover`	获取专辑封面 URL

VIP 内容访问

如需获取 VIP 歌曲的高品质播放链接，请设置环境变量：

export QQ_MUSIC_COOKIE="your_qq_music_cookie_here"

或在 Claude Desktop 配置中添加：

{
  "mcpServers": {
    "qq-music": {
      "command": "uvx",
      "args": ["qq-music-mcp"],
      "env": {
        "QQ_MUSIC_COOKIE": "your_cookie_here"
      }
    }
  }
}

获取 Cookie 的步骤：

打开浏览器访问 https://y.qq.com
登录你的 QQ 账号
打开开发者工具 (F12) -> Application -> Cookies
复制完整的 Cookie 字符串

音质类型说明

音质代码	说明
`m4a`	AAC 格式
`128`	128kbps MP3
`320`	320kbps MP3
`flac`	FLAC 无损
`ape`	APE 无损
`hires`	臻品母带 (24bit/192kHz)
`atmos`	臻品全景声 (Dolby Atmos)

开发

# 克隆项目
git clone https://github.com/yourusername/qq-music-mcp.git
cd qq-music-mcp

# 安装依赖
uv sync

# 运行测试
uv run mcp dev src/qq_music_api/server.py

作为 Python 库使用

import asyncio
from qq_music_api import QQMusicClient

async def main():
    async with QQMusicClient() as client:
        # 搜索歌曲
        result = await client.search("周杰伦")
        print(result)

        # 获取歌词
        lyric = await client.get_lyric("000paPeF1SZp2I")
        print(lyric)

asyncio.run(main())

许可证

MIT

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official

Featured