关于 Audiobookshelf
Audiobookshelf MCP Server 为 AI 助手提供对自托管有声书和播客库的只读访问。其工具涵盖资料库搜索、项目详情、收听进度和播放统计。
主要功能
- 01列出并搜索资料库
- 02查看有声书和播客详情
- 03检查当前收听进度
- 04查看收听记录与统计
- 05浏览系列、作者和合集
适用场景
- 01按书名、作者或朗读者查找内容
- 02查看当前有声书的收听位置
- 03回顾近期收听内容和总时长
MCP 相关
该 MCP 服务将 Audiobookshelf 的资料库、项目和播放信息作为工具提供给 MCP 客户端。工具仅供读取，不支持播放控制或用户管理。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。
详细介绍
Audiobookshelf MCP 服务
一个适用于 Audiobookshelf 的 Model Context Protocol 服务，可让 AI 助手访问你自托管的有声书和播客资料库。
MCP Registry 名称：mcp-name: io.github.sierikov/audiobookshelf-mcp
它能做什么？
你可以向 AI 助手提问，例如：
- “我目前在听什么？”
- “在我的资料库中搜索《沙丘》”
- “我的收听统计数据是什么？”
- “我最近听了什么？”
- “《Katabasis》我听到哪里了？”
- “我有哪些资料库？”
工具
| 工具 | 描述 | 工具集 |
|---|---|---|
list_libraries | 列出所有资料库 | libraries |
search_library | 按标题、作者或朗读者搜索 | libraries |
list_library_items | 分页列出条目 | libraries |
get_item | 获取有声书或播客的详细信息 | items |
get_items_in_progress | 获取正在收听的条目及其进度 | items |
get_listening_stats | 总收听时长和每日明细 | playback |
get_listening_sessions | 最近的收听会话 | playback |
get_media_progress | 获取特定条目的进度 | playback |
list_series | 列出资料库中的所有系列 | browse |
get_series | 获取系列详情及书籍 | browse |
get_author | 获取作者详情及书籍 | browse |
list_collections | 列出资料库中的合集 | browse |
默认工具集：libraries、items、playback。browse 工具集可通过 AUDIOBOOKSHELF_TOOLSETS 选择启用。
在 Claude Desktop 中安装（一键安装）
下载适用于你平台的 .mcpb 安装包，打开后，Claude Desktop 将引导你完成设置。
| 平台 | 下载 |
|---|---|
| macOS（Apple Silicon） | audiobookshelf-mcp-macos-arm64.mcpb |
| macOS（Intel） | audiobookshelf-mcp-macos-amd64.mcpb |
| Windows | audiobookshelf-mcp-windows-amd64.mcpb |
| Linux x64 | audiobookshelf-mcp-linux-amd64.mcpb |
| Linux arm64 | audiobookshelf-mcp-linux-arm64.mcpb |
.mcpb格式目前仅受 Claude Desktop 支持。其他客户端请使用下方的手动设置方式。
手动设置（适用于所有其他客户端）
1. 获取你的 API 令牌
Audiobookshelf → 设置 → 用户 → 你的用户 → API 令牌
2. 安装二进制文件
go install：
go install github.com/sierikov/audiobookshelf-mcp/cmd/audiobookshelf-mcp@latest
下载并安装到 /usr/local/bin：
macOS（Apple Silicon）
curl -L https://github.com/sierikov/audiobookshelf-mcp/releases/latest/download/audiobookshelf-mcp-macos-arm64 \
-o /usr/local/bin/audiobookshelf-mcp && chmod +x /usr/local/bin/audiobookshelf-mcp
macOS（Intel）
curl -L https://github.com/sierikov/audiobookshelf-mcp/releases/latest/download/audiobookshelf-mcp-macos-amd64 \
-o /usr/local/bin/audiobookshelf-mcp && chmod +x /usr/local/bin/audiobookshelf-mcp
Linux（x64）
curl -L https://github.com/sierikov/audiobookshelf-mcp/releases/latest/download/audiobookshelf-mcp-linux-amd64 \
-o /usr/local/bin/audiobookshelf-mcp && chmod +x /usr/local/bin/audiobookshelf-mcp
Linux（arm64）
curl -L https://github.com/sierikov/audiobookshelf-mcp/releases/latest/download/audiobookshelf-mcp-linux-arm64 \
-o /usr/local/bin/audiobookshelf-mcp && chmod +x /usr/local/bin/audiobookshelf-mcp
Windows
下载 audiobookshelf-mcp-windows-amd64.exe，将其重命名为 audiobookshelf-mcp.exe，并放入 %PATH% 中的某个目录（例如 C:\Program Files\audiobookshelf-mcp\）。
3. 配置客户端
Claude Code
claude mcp add audiobookshelf \
-e AUDIOBOOKSHELF_URL=https://abs.example.com \
-e AUDIOBOOKSHELF_TOKEN=your-token \
-- audiobookshelf-mcp
Antigravity CLI（原名 Gemini CLI）
antigravity --add-mcp '{"name":"audiobookshelf","command":"audiobookshelf-mcp","env":{"AUDIOBOOKSHELF_URL":"https://abs.example.com","AUDIOBOOKSHELF_TOKEN":"your-token"}}'
OpenCode
添加到 ~/.config/opencode/config.json：
{
"mcpServers": {
"audiobookshelf": {
"type": "stdio",
"command": "audiobookshelf-mcp",
"args": [],
"env": {
"AUDIOBOOKSHELF_URL": "https://abs.example.com",
"AUDIOBOOKSHELF_TOKEN": "your-token"
}
}
}
}
配置
| 变量 | 必需 | 默认值 | 描述 |
|---|---|---|---|
AUDIOBOOKSHELF_URL | 是 | — | 你的 Audiobookshelf 服务 URL |
AUDIOBOOKSHELF_TOKEN | 是 | — | 从 Settings → Users 获取的 API 令牌 |
AUDIOBOOKSHELF_TOOLSETS | 否 | libraries,items,playback | 要启用的工具集，以逗号分隔。使用 all 可启用全部工具集。 |
安全性
所有工具均为只读——不会写入数据、控制播放或管理用户。API 令牌通过环境变量传递，绝不会被记录或泄露。
许可证
MIT
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。