Сервер Model Context Protocol (MCP), который предоставляет инструменты для взаимодействия с экземпляром Audiobookshelf. Доступ к вашим библиотекам, аудиокнигам, подкастам, авторам, коллекциям и плейлистам через помощников ИИ, которые поддерживают MCP.

##Отказ от ответственности

Используйте свой собственный риск:* Это программное обеспечение предоставляется «как есть» без какой-либо гарантии. Автор не несет ответственности за любое неправильное использование, несчастные случаи, потерю данных или любые другие проблемы, которые могут возникнуть в результате использования этого программного обеспечения. Пользователи несут единоличную ответственность за обеспечение правильной настройки и использования этого инструмента с их экземпляром Audiobookshelf.

Особенности

Список и извлечение библиотек с дополнительными подресурсами (пункты, авторы)

• Получить отдельные предметы (аудиокниги или подкасты) Просмотр авторов и их работ
• Доступ к коллекциям и плейлистам
• Восстановление пользовательской информации

##Установка

Предпосылки

• экземпляр аудиокниги с доступом к API
• Токен API из вашего экземпляра Audiobookshelf

Рекомендуемый: Загрузите предварительно созданный выпуск

** Самый простой способ установки - загрузить предварительно построенный двоичный файл из последнего выпуска.**

| Платформа | Архитектура | Имя файла

Audiobookshelf MCP Server

A Model Context Protocol (MCP) server that provides tools to interact with your Audiobookshelf instance. Access your libraries, audiobooks, podcasts, authors, collections, and playlists through AI assistants that support MCP.

Disclaimer

USE AT YOUR OWN RISK: This software is provided “as is” without warranty of any kind. The author is not responsible for any misuse, accidents, data loss, or any other issues that may arise from using this software. Users are solely responsible for ensuring proper configuration and usage of this tool with their Audiobookshelf instance.

---

Features

• List and retrieve libraries with optional sub-resources (items, authors)
• Get individual items (audiobooks or podcasts)
• Browse authors and their works
• Access collections and playlists
• Retrieve user information

Installation

Prerequisites

• An Audiobookshelf instance with API access
• An API token from your Audiobookshelf instance

Recommended: Download Pre-built Release

The easiest way to install is to download a pre-built binary from the latest release.

Installation steps:

1. Download the appropriate archive for your platform from the releases page
2. Extract the archive:

   tar -xzf audiobookshelf-mcp_VERSION_PLATFORM.tar.gz
   

3. Move the binary to a location in your PATH (optional but recommended):

   # macOS/Linux
   sudo mv abs-mcp /usr/local/bin/
   
   # Or to a user directory
   mv abs-mcp ~/.local/bin/
   

4. Make it executable (macOS/Linux):

   chmod +x /usr/local/bin/abs-mcp
   

Alternative: Build from Source

If you prefer to build from source:

Prerequisites:

• Go 1.21 or later

git clone 
cd abs-mcp
go build

Configuration

The MCP server requires two pieces of configuration:

1. ABS_BASE_URL - The base URL of your Audiobookshelf instance (e.g., https://abs.example.com)
2. ABS_API_KEY - Your Audiobookshelf API token

Getting Your API Token

1. Log into your Audiobookshelf instance
2. Go to Settings → Users → Your User
3. Click “Generate API Token” or copy your existing token

Usage

Environment Variables