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 → Settings → Users → ご自身のユーザー → API Token
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 サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。