福艾
foobar2000的AI MCP控制。 使用AI助手控制您的音乐播放器!
概述
此组件启动本地 模型上下文协议 服务器。你可以用任何 MCP客户端 支持SSE(用GitHub Copilot和Cursor测试)。
AI助手可以发送请求,从正在运行的音乐播放器中获取信息 或者调用播放、创建播放列表、更改音量等操作。
兼容foobar v2.0+、x86和x64。
示例任务
- “制作一个新的80年代摇滚播放列表并播放。”
- “当前播放的曲目的名称是什么?”
- “将此曲目添加到我的“收藏夹”播放列表中。”
- “我图书馆里最古老的歌是什么?”
- “把音量调大一点。”
Example - creating a playlist with Kaczmarski's best songs
安装
- 从下载最新版本 发布 页面。
- 双击下载的
.fb2k-component安装组件的文件。 - 如果foobar2000正在运行,请重新启动它。
- 默认情况下,服务器将侦听
http://localhost:9910/sse.
您可以在设置中更改主机和端口(首选项>工具>AI)。
- 将上一步的URL添加到您的MCP客户端,瞧!
可用特征
工具
服务器提供以下功能 工具:
list_library:列出库中的所有曲目。可以指定查询字符串。list_playlists:列出所有播放列表。list_playlist:列出特定播放列表中的曲目。可以指定查询字符串。list_current_track:获取当前播放曲目的信息。add_tracks:将曲目添加到播放列表。remove_tracks:从播放列表中删除曲目。remove_all_tracks:从播放列表中删除所有曲目。move_tracks:在播放列表中移动曲目。set_active_playlist:设置活动播放列表(UI中显示的播放列表)。set_playing_playlist:设置播放列表(fb2k从中挑选曲目的播放列表)。set_playback_state:播放或暂停音乐。play_at_index:在活动播放列表中的特定索引处播放曲目。set_focus:将焦点设置为活动播放列表中的特定曲目(不播放)。create_playlist:创建新的播放列表。rename_playlist:重命名播放列表。delete_playlist:删除播放列表。set_volume:设置音量。toggle_mute:切换静音状态。get_volume:获取当前音量和静音状态。
资源
服务器提供了一些 资源. 它们是为了支持订阅而提供的。当客户端订阅资源时, 每当在播放器中更新时,它都会收到更新。
这不是一个关键功能,因为客户总是可以调用这些工具来获取最新信息, 但如果您的MCP客户端支持,它对于实时更新可能很有用。
以下资源可用:
current_track://.:包含有关当前曲目的信息:上次更改的时间以及播放/暂停状态。playlists://.:包含与相同的信息list_playlists工具-播放列表名称、曲目计数、,
最后修改时间、活动/播放状态等。
volume://.:包含与相同的信息get_volume工具。
