使用说明
福艾
foobar2000的AI MCP控制。 使用AI助手控制您的音乐播放器！
概述
此组件启动本地 模型上下文协议 服务器。你可以用任何 MCP客户端 支持SSE（用GitHub Copilot和Cursor测试）。
AI助手可以发送请求，从正在运行的音乐播放器中获取信息 或者调用播放、创建播放列表、更改音量等操作。
兼容foobar v2.0+、x86和x64。
示例任务
- “制作一个新的80年代摇滚播放列表并播放。”
- “当前播放的曲目的名称是什么？”
- “将此曲目添加到我的“收藏夹”播放列表中。”
- “我图书馆里最古老的歌是什么？”
- “把音量调大一点。”
安装
- 从下载最新版本 发布 页面。
- 双击下载的
.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工具。
