StreamerSongList MCP服务器
](https://smithery.ai/server/@vuvuvu/streamersonglist-mcp)   ](https://nodejs.org/)
MCP服务器公开只读StreamerSongList工具。使用LLM与Live Streamers歌曲列表进行交互。Claude Desktop和任何MCP客户端。
快速开始
- 需要Node.js 18+
- Claude Desktop建议日常使用
通过npx添加到克劳德桌面:
{
"mcpServers": {
"streamersonglist": {
"command": "npx",
"args": ["streamersonglist-mcp"]
}
}
}看 claude-desktop-config.with-default-streamer.json 例如,配置了DEFAULT_STREAMER。
单击smithery徽章测试mcp服务器或部署自己的服务器。
](https://smithery.ai/server/@vuvuvu/streamersonglist-mcp)
可选的Smithery安装(需要Smithery帐户):
# First login to Smithery (one-time setup)
npx -y @smithery/cli login
# Then install the MCP server
npx -y @smithery/cli install @vuvuvu/streamersonglist-mcp --client claude部署到Smithery.ai
想在不进行任何本地设置的情况下立即测试此MCP服务器吗?点击上方的Smithery徽章或访问:
Smithery.ai提供了一个托管环境,您可以在其中:
- 立即在浏览器中测试所有StreamerSongList工具
- 无需安装或配置
- 非常适合在本地设置之前试用服务器
- 非常适合与他人分享或快速演示
只需单击此README顶部的徽章或上面的链接即可立即开始!
检查/调试(推荐)
使用MCP检查器浏览工具并以交互方式运行请求:
npx @modelcontextprotocol/inspector@latest -- npx streamersonglist-mcp
# or from a local clone
npx @modelcontextprotocol/inspector@latest -- node src/server.js替代方案(原始stdio):
npm start
printf '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}\n' | node src/server.js可用工具(共6个)
✅ 所有真实API数据(6个工具)
- getStreamerByName --获取全面的流媒体配置
- getQueue --按页码列出当前歌曲队列
- 获取歌曲 --获取带有分页的完整歌曲列表
- 搜索歌曲 --按标题或艺术家搜索歌曲
- getSong详细信息 --获取特定歌曲的详细信息
- 监视器队列 --使用真实数据监控队列更改
使用示例
有关如何使用这些工具的全面示例,请参阅 docs/USAGE_EXAMPLES.md 包括:
- 🎵 音乐发现与分析
- 📊 内容创建者工具和流规划
- 🤖 AI助手集成和智能推荐
- 📈 数据分析和见解
- 🎪 活动策划和协作工具
- 🛠️ 技术应用和自动化
快速示例:
// Search for songs
{"tool": "searchSongs", "arguments": {"streamerName": "belleune", "query": "Frank Sinatra"}}
// Get most popular songs
{"tool": "getSongs", "arguments": {"streamerName": "belleune", "limit": 20}}
// Compare streamer libraries
{"tool": "getSongs", "arguments": {"streamerName": "vu_vu", "limit": 50}}API状态
工作端点:所有6个工具都使用真实的API数据
- 流媒体信息、队列管理和完整歌曲库访问
- 公共终结点不需要身份验证
- 所有功能与真实的StreamerSongList API数据一起完全发挥作用
#使用streampersonglists api时请慎重考虑。这是一个共享但有限的资源,在使用LLM访问它时要注意,请不要毁了它!
有关API测试结果的详细信息,请参见 docs/API_TESTING_REPORT.md文件
环境
可选择设置在以下情况下使用的默认拖缆 streamerName 省略:
{
"mcpServers": {
"streamersonglist": {
"command": "npx",
"args": ["streamersonglist-mcp"],
"env": { "DEFAULT_STREAMER": "public_streamer" }
}
}
}CLI覆盖示例:
DEFAULT_STREAMER=public_streamer npx streamersonglist-mcp
npx streamersonglist-mcp --streamer public_streamer配置选项:
DEFAULT_STREAMER--省略参数时的默认拖缆SSL_API_BASE-覆盖API基础(默认值https://api.streamersonglist.com/v1)
版本信息:服务器从报告其版本 package.json,与已发布的包匹配。
安全提示:仅使用公共流媒体名称;服务器调用公共只读端点。
脚本
npm install--安装依赖项npm start--在stdio上运行服务器npm test--生成服务器并验证工具/列表npm run setup--生成克劳德桌面条目
许可证
麻省理工学院——见 LICENSE.
贡献
欢迎通过pull请求进行贡献。由于公共StreamerSongList API的限制,主要新功能的范围有意适度-有益的贡献包括:
- Bug修复、错误处理和健壮性改进
- 文档更新和示例
- 小型工具或DX增强功能(测试、CI、配置)
请在开始工作之前打开一个问题来讨论更大的想法,然后运行 npm test 在提交PR之前。
鸣谢
该项目建立在优秀的StreamerSonglist服务之上。StreamerSonist提供所有数据和API功能:
- https://www.streamersonglist.com
我与StreamerSonglist没有附属关系,也没有得到StreamerSongist的支持,所以请不要在我的代码中发现任何问题来打扰他们。 感谢Streamersonglist为流媒体社区提供如此有用的服务。非常胖
