Calibre-Web

السجل الرسمي البحث والويب

Read-only MCP server for Calibre-Web: library search, browsing and covers via the OPDS feed

التثبيت

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

NPM package calibreweb-mcp
Claude Code
claude mcp add calibre-web -e 'CALIBRE_WEB_URL=<CALIBRE_WEB_URL>' -e 'CALIBRE_WEB_USERNAME=<CALIBRE_WEB_USERNAME>' -e 'CALIBRE_WEB_PASSWORD=<your calibre_web_password>' -e 'CALIBRE_WEB_INSECURE_TLS=<CALIBRE_WEB_INSECURE_TLS>' -e 'CALIBRE_WEB_ALLOW_TOOLS=<CALIBRE_WEB_ALLOW_TOOLS>' -e 'CALIBRE_WEB_DENY_TOOLS=<CALIBRE_WEB_DENY_TOOLS>' -- npx -y calibreweb-mcp@0.3.1
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "calibre-web": {
            "command": "npx",
            "args": [
                "-y",
                "calibreweb-mcp@0.3.1"
            ],
            "env": {
                "CALIBRE_WEB_URL": "<CALIBRE_WEB_URL>",
                "CALIBRE_WEB_USERNAME": "<CALIBRE_WEB_USERNAME>",
                "CALIBRE_WEB_PASSWORD": "<your calibre_web_password>",
                "CALIBRE_WEB_INSECURE_TLS": "<CALIBRE_WEB_INSECURE_TLS>",
                "CALIBRE_WEB_ALLOW_TOOLS": "<CALIBRE_WEB_ALLOW_TOOLS>",
                "CALIBRE_WEB_DENY_TOOLS": "<CALIBRE_WEB_DENY_TOOLS>"
            }
        }
    }
}

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

  • CALIBRE_WEB_URL إلزامي Root URL of the Calibre-Web instance, e.g. https://books.example.com
  • CALIBRE_WEB_USERNAME Username of the Calibre-Web account (web login); leave unset together with the password for anonymous-browsing instances
  • CALIBRE_WEB_PASSWORD سري Password of that account (web login password)
  • CALIBRE_WEB_INSECURE_TLS Set to true to accept self-signed certificates (scoped to the configured host)
  • CALIBRE_WEB_ALLOW_TOOLS Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
  • CALIBRE_WEB_DENY_TOOLS Comma-separated tool names or list_* prefixes to remove from whatever CALIBRE_WEB_ALLOW_TOOLS left
OCI package ghcr.io/ni-c/calibreweb-mcp:0.3.1
Claude Code
claude mcp add calibre-web -e 'CALIBRE_WEB_URL=<CALIBRE_WEB_URL>' -e 'CALIBRE_WEB_USERNAME=<CALIBRE_WEB_USERNAME>' -e 'CALIBRE_WEB_PASSWORD=<your calibre_web_password>' -e 'CALIBRE_WEB_INSECURE_TLS=<CALIBRE_WEB_INSECURE_TLS>' -e 'CALIBRE_WEB_ALLOW_TOOLS=<CALIBRE_WEB_ALLOW_TOOLS>' -e 'CALIBRE_WEB_DENY_TOOLS=<CALIBRE_WEB_DENY_TOOLS>' -- docker run -i --rm ghcr.io/ni-c/calibreweb-mcp:0.3.1
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "calibre-web": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/ni-c/calibreweb-mcp:0.3.1"
            ],
            "env": {
                "CALIBRE_WEB_URL": "<CALIBRE_WEB_URL>",
                "CALIBRE_WEB_USERNAME": "<CALIBRE_WEB_USERNAME>",
                "CALIBRE_WEB_PASSWORD": "<your calibre_web_password>",
                "CALIBRE_WEB_INSECURE_TLS": "<CALIBRE_WEB_INSECURE_TLS>",
                "CALIBRE_WEB_ALLOW_TOOLS": "<CALIBRE_WEB_ALLOW_TOOLS>",
                "CALIBRE_WEB_DENY_TOOLS": "<CALIBRE_WEB_DENY_TOOLS>"
            }
        }
    }
}

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

  • CALIBRE_WEB_URL إلزامي Root URL of the Calibre-Web instance, e.g. https://books.example.com
  • CALIBRE_WEB_USERNAME Username of the Calibre-Web account (web login); leave unset together with the password for anonymous-browsing instances
  • CALIBRE_WEB_PASSWORD سري Password of that account (web login password)
  • CALIBRE_WEB_INSECURE_TLS Set to true to accept self-signed certificates (scoped to the configured host)
  • CALIBRE_WEB_ALLOW_TOOLS Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
  • CALIBRE_WEB_DENY_TOOLS Comma-separated tool names or list_* prefixes to remove from whatever CALIBRE_WEB_ALLOW_TOOLS left

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

ما هو Calibre-Web؟

Read-only MCP server for Calibre-Web: library search, browsing and covers via the OPDS feed

كيف أثبّت Calibre-Web؟

يعمل على جهازك. في Claude Code: claude mcp add calibre-web -e 'CALIBRE_WEB_URL=<CALIBRE_WEB_URL>' -e 'CALIBRE_WEB_USERNAME=<CALIBRE_WEB_USERNAME>' -e 'CALIBRE_WEB_PASSWORD=<your calibre_web_password>' -e 'CALIBRE_WEB_INSECURE_TLS=<CALIBRE_WEB_INSECURE_TLS>' -e 'CALIBRE_WEB_ALLOW_TOOLS=<CALIBRE_WEB_ALLOW_TOOLS>' -e 'CALIBRE_WEB_DENY_TOOLS=<CALIBRE_WEB_DENY_TOOLS>' -- npx -y calibreweb-mcp@0.3.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Calibre-Web إلى مفتاح API؟

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

هل Calibre-Web مفتوح المصدر؟

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

من يصون Calibre-Web؟

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

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