English Français العربية

Audiobookshelf

السجل الرسمي الوسائط والتصميم

Browse your Audiobookshelf libraries and keep listening progress, bookmarks and playlists in sync

الشيفرة المصدرية الموقع

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package audiobookshelf-mcp
Claude Code 
claude mcp add audiobookshelf -e 'AUDIOBOOKSHELF_URL=<AUDIOBOOKSHELF_URL>' -e 'AUDIOBOOKSHELF_API_KEY=<your audiobookshelf_api_key>' -e 'AUDIOBOOKSHELF_READ_ONLY=<AUDIOBOOKSHELF_READ_ONLY>' -e 'AUDIOBOOKSHELF_INSECURE_TLS=<AUDIOBOOKSHELF_INSECURE_TLS>' -e 'AUDIOBOOKSHELF_ALLOW_TOOLS=<AUDIOBOOKSHELF_ALLOW_TOOLS>' -e 'AUDIOBOOKSHELF_DENY_TOOLS=<AUDIOBOOKSHELF_DENY_TOOLS>' -- npx -y audiobookshelf-mcp@0.4.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "audiobookshelf": {
            "command": "npx",
            "args": [
                "-y",
                "audiobookshelf-mcp@0.4.0"
            ],
            "env": {
                "AUDIOBOOKSHELF_URL": "<AUDIOBOOKSHELF_URL>",
                "AUDIOBOOKSHELF_API_KEY": "<your audiobookshelf_api_key>",
                "AUDIOBOOKSHELF_READ_ONLY": "<AUDIOBOOKSHELF_READ_ONLY>",
                "AUDIOBOOKSHELF_INSECURE_TLS": "<AUDIOBOOKSHELF_INSECURE_TLS>",
                "AUDIOBOOKSHELF_ALLOW_TOOLS": "<AUDIOBOOKSHELF_ALLOW_TOOLS>",
                "AUDIOBOOKSHELF_DENY_TOOLS": "<AUDIOBOOKSHELF_DENY_TOOLS>"
            }
        }
    }
}

متغيرات البيئة

  • AUDIOBOOKSHELF_URL إلزامي Base URL of the Audiobookshelf instance, e.g. https://abs.example.com
  • AUDIOBOOKSHELF_API_KEY إلزامي سري API key from Settings -> Users -> API Keys (Audiobookshelf 2.26.0 or newer)
  • AUDIOBOOKSHELF_READ_ONLY Set to true to register only the 29 read tools and no write tools
  • AUDIOBOOKSHELF_INSECURE_TLS Set to true to accept self-signed certificates for this connection only
  • AUDIOBOOKSHELF_ALLOW_TOOLS Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
  • AUDIOBOOKSHELF_DENY_TOOLS Comma-separated tool names or list_* prefixes to remove from whatever AUDIOBOOKSHELF_ALLOW_TOOLS left
OCI package ghcr.io/ni-c/audiobookshelf-mcp:0.4.0
Claude Code 
claude mcp add audiobookshelf -e 'AUDIOBOOKSHELF_URL=<AUDIOBOOKSHELF_URL>' -e 'AUDIOBOOKSHELF_API_KEY=<your audiobookshelf_api_key>' -e 'AUDIOBOOKSHELF_READ_ONLY=<AUDIOBOOKSHELF_READ_ONLY>' -e 'AUDIOBOOKSHELF_INSECURE_TLS=<AUDIOBOOKSHELF_INSECURE_TLS>' -e 'AUDIOBOOKSHELF_ALLOW_TOOLS=<AUDIOBOOKSHELF_ALLOW_TOOLS>' -e 'AUDIOBOOKSHELF_DENY_TOOLS=<AUDIOBOOKSHELF_DENY_TOOLS>' -- docker run -i --rm ghcr.io/ni-c/audiobookshelf-mcp:0.4.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "audiobookshelf": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/ni-c/audiobookshelf-mcp:0.4.0"
            ],
            "env": {
                "AUDIOBOOKSHELF_URL": "<AUDIOBOOKSHELF_URL>",
                "AUDIOBOOKSHELF_API_KEY": "<your audiobookshelf_api_key>",
                "AUDIOBOOKSHELF_READ_ONLY": "<AUDIOBOOKSHELF_READ_ONLY>",
                "AUDIOBOOKSHELF_INSECURE_TLS": "<AUDIOBOOKSHELF_INSECURE_TLS>",
                "AUDIOBOOKSHELF_ALLOW_TOOLS": "<AUDIOBOOKSHELF_ALLOW_TOOLS>",
                "AUDIOBOOKSHELF_DENY_TOOLS": "<AUDIOBOOKSHELF_DENY_TOOLS>"
            }
        }
    }
}

متغيرات البيئة

  • AUDIOBOOKSHELF_URL إلزامي Base URL of the Audiobookshelf instance, e.g. https://abs.example.com
  • AUDIOBOOKSHELF_API_KEY إلزامي سري API key from Settings -> Users -> API Keys (Audiobookshelf 2.26.0 or newer)
  • AUDIOBOOKSHELF_READ_ONLY Set to true to register only the 29 read tools and no write tools
  • AUDIOBOOKSHELF_INSECURE_TLS Set to true to accept self-signed certificates for this connection only
  • AUDIOBOOKSHELF_ALLOW_TOOLS Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
  • AUDIOBOOKSHELF_DENY_TOOLS Comma-separated tool names or list_* prefixes to remove from whatever AUDIOBOOKSHELF_ALLOW_TOOLS left

الأسئلة الشائعة

ما هو Audiobookshelf؟

Browse your Audiobookshelf libraries and keep listening progress, bookmarks and playlists in sync

كيف أثبّت Audiobookshelf؟

يعمل على جهازك. في Claude Code: claude mcp add audiobookshelf -e 'AUDIOBOOKSHELF_URL=<AUDIOBOOKSHELF_URL>' -e 'AUDIOBOOKSHELF_API_KEY=<your audiobookshelf_api_key>' -e 'AUDIOBOOKSHELF_READ_ONLY=<AUDIOBOOKSHELF_READ_ONLY>' -e 'AUDIOBOOKSHELF_INSECURE_TLS=<AUDIOBOOKSHELF_INSECURE_TLS>' -e 'AUDIOBOOKSHELF_ALLOW_TOOLS=<AUDIOBOOKSHELF_ALLOW_TOOLS>' -e 'AUDIOBOOKSHELF_DENY_TOOLS=<AUDIOBOOKSHELF_DENY_TOOLS>' -- npx -y audiobookshelf-mcp@0.4.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Audiobookshelf إلى مفتاح API؟

نعم. يتطلب AUDIOBOOKSHELF_URL, AUDIOBOOKSHELF_API_KEY، وتضبطها في إعداداته.

هل Audiobookshelf مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Audiobookshelf؟

ينشره ni-c. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.