michaeldvinci/audiobookshelf-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

11 stars 6 forks 품질 63 트렌드 18GPL-3.0

Repository Install

MCP server for [current] Audiobookshelf API

개요

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. 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. - 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 - An Audiobookshelf instance with API access - An API token from your Audiobookshelf instance 1. Download the appropriate archive for your platform from the releases page 2. Extract the archive: 3.

README

원문 README의 일부입니다. 원문 보기.

Audiobookshelf MCP Server

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.

Platform	Architecture	Filename
macOS	Intel (x86_64)	`audiobookshelf-mcp_VERSION_darwin_amd64.tar.gz`
macOS	Apple Silicon (ARM64)	`audiobookshelf-mcp_VERSION_darwin_arm64.tar.gz`
Linux	64-bit (x86_64)	`audiobookshelf-mcp_VERSION_linux_amd64.tar.gz`
Linux	ARM64	`audiobookshelf-mcp_VERSION_linux_arm64.tar.gz`
Linux	32-bit (x86)	`audiobookshelf-mcp_VERSION_linux_386.tar.gz`
Windows	64-bit (x86_64)	`audiobookshelf-mcp_VERSION_windows_amd64.tar.gz`
Windows	ARM64	`audiobookshelf-mcp_VERSION_windows_arm64.tar.gz`
Windows	32-bit (x86)	`audiobookshelf-mcp_VERSION_windows_386.tar.gz`

Installation steps:

Download the appropriate archive for your platform from the releases page

Extract the archive:

tar -xzf audiobookshelf-mcp_VERSION_PLATFORM.tar.gz

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/

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:

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

Getting Your API Token

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

Usage

Environment Variables

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "audiobookshelf": {
      "command": "/path/to/abs-mcp",
      "env": {
        "ABS_BASE_URL": "https://abs.example.com",
        "ABS_API_KEY": "your-api-token-here"
      }
    }
  }
}