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"
      }
    }
  }
}