English Français العربية

Audiobookshelf MCP

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

Inspect and safely operate Audiobookshelf libraries over MCP.

الشيفرة المصدرية

التثبيت

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

OCI package ghcr.io/jeeftor/abs-mcp:0.6.0
Claude Code 
claude mcp add audiobookshelf-mcp -e 'ABS_BASE_URL=<ABS_BASE_URL>' -e 'ABS_API_KEY=<your abs_api_key>' -e 'ABS_READ_ONLY=true' -e 'ABS_TIMEOUT=30s' -e 'ABS_FIXTURE_DIR=test/abs' -e 'ABS_EXTRA_HEADERS_FILE=<ABS_EXTRA_HEADERS_FILE>' -e 'ABS_TLS_CA_CERT_FILE=<ABS_TLS_CA_CERT_FILE>' -e 'ABS_TLS_INSECURE_SKIP_VERIFY=false' -e 'ABS_TRANSPORT=stdio' -e 'ABS_HTTP_ADDR=127.0.0.1:3333' -e 'ABS_HTTP_PATH=/mcp' -e 'ABS_HTTP_BEARER_TOKEN=<your abs_http_bearer_token>' -- docker run -i --rm ghcr.io/jeeftor/abs-mcp:0.6.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "audiobookshelf-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/jeeftor/abs-mcp:0.6.0"
            ],
            "env": {
                "ABS_BASE_URL": "<ABS_BASE_URL>",
                "ABS_API_KEY": "<your abs_api_key>",
                "ABS_READ_ONLY": "true",
                "ABS_TIMEOUT": "30s",
                "ABS_FIXTURE_DIR": "test/abs",
                "ABS_EXTRA_HEADERS_FILE": "<ABS_EXTRA_HEADERS_FILE>",
                "ABS_TLS_CA_CERT_FILE": "<ABS_TLS_CA_CERT_FILE>",
                "ABS_TLS_INSECURE_SKIP_VERIFY": "false",
                "ABS_TRANSPORT": "stdio",
                "ABS_HTTP_ADDR": "127.0.0.1:3333",
                "ABS_HTTP_PATH": "/mcp",
                "ABS_HTTP_BEARER_TOKEN": "<your abs_http_bearer_token>"
            }
        }
    }
}

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

  • ABS_BASE_URL إلزامي Base URL of your Audiobookshelf server.
  • ABS_API_KEY إلزامي سري Audiobookshelf API key or bearer token.
  • ABS_READ_ONLY Set to false to enable scan and cleanup tools.
  • ABS_TIMEOUT Audiobookshelf request timeout as a Go duration or seconds.
  • ABS_FIXTURE_DIR Optional local ABS fixture directory for fixture resources.
  • ABS_EXTRA_HEADERS_FILE Optional JSON file containing extra request headers.
  • ABS_TLS_CA_CERT_FILE Optional PEM CA bundle for private or corporate ABS TLS.
  • ABS_TLS_INSECURE_SKIP_VERIFY Temporary TLS verification bypass for local troubleshooting.
  • ABS_TRANSPORT MCP transport to run at startup. Use stdio for local launchers or http for Streamable HTTP.
  • ABS_HTTP_ADDR Bind address used when ABS_TRANSPORT=http.
  • ABS_HTTP_PATH Streamable HTTP endpoint path used when ABS_TRANSPORT=http.
  • ABS_HTTP_BEARER_TOKEN سري Optional bearer token required from Streamable HTTP MCP clients.

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

ما هو Audiobookshelf MCP؟

Inspect and safely operate Audiobookshelf libraries over MCP.

كيف أثبّت Audiobookshelf MCP؟

يعمل على جهازك. في Claude Code: claude mcp add audiobookshelf-mcp -e 'ABS_BASE_URL=<ABS_BASE_URL>' -e 'ABS_API_KEY=<your abs_api_key>' -e 'ABS_READ_ONLY=true' -e 'ABS_TIMEOUT=30s' -e 'ABS_FIXTURE_DIR=test/abs' -e 'ABS_EXTRA_HEADERS_FILE=<ABS_EXTRA_HEADERS_FILE>' -e 'ABS_TLS_CA_CERT_FILE=<ABS_TLS_CA_CERT_FILE>' -e 'ABS_TLS_INSECURE_SKIP_VERIFY=false' -e 'ABS_TRANSPORT=stdio' -e 'ABS_HTTP_ADDR=127.0.0.1:3333' -e 'ABS_HTTP_PATH=/mcp' -e 'ABS_HTTP_BEARER_TOKEN=<your abs_http_bearer_token>' -- docker run -i --rm ghcr.io/jeeftor/abs-mcp:0.6.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

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

نعم. يتطلب ABS_BASE_URL, ABS_API_KEY, ABS_HTTP_BEARER_TOKEN، وتضبطها في إعداداته.

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

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

من يصون Audiobookshelf MCP؟

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

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