Yuque MCP

السجل الرسمي الإنتاجية

Yuque MCP server with safe read/write tools for groups, group members, repositories, docs, and TOC.

التثبيت

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

NPM package @wwwwwujl/yuque-mcp
Claude Code
claude mcp add yuque-mcp -e 'YUQUE_TOKEN=<your yuque_token>' -e 'YUQUE_ENDPOINT=<YUQUE_ENDPOINT>' -e 'YUQUE_TIMEOUT_MS=<YUQUE_TIMEOUT_MS>' -e 'YUQUE_MAX_RETRIES=<YUQUE_MAX_RETRIES>' -e 'YUQUE_ALLOW_WRITE=<YUQUE_ALLOW_WRITE>' -e 'YUQUE_WRITE_NAMESPACE_ALLOWLIST=<YUQUE_WRITE_NAMESPACE_ALLOWLIST>' -e 'YUQUE_WRITE_GROUP_ALLOWLIST=<YUQUE_WRITE_GROUP_ALLOWLIST>' -e 'YUQUE_ALLOW_DELETE=<YUQUE_ALLOW_DELETE>' -e 'YUQUE_DELETE_NAMESPACE_ALLOWLIST=<YUQUE_DELETE_NAMESPACE_ALLOWLIST>' -e 'YUQUE_FILE_ROOT=<YUQUE_FILE_ROOT>' -e 'YUQUE_FILE_MAX_BYTES=<YUQUE_FILE_MAX_BYTES>' -e 'YUQUE_FILE_ALLOWED_EXTENSIONS=<YUQUE_FILE_ALLOWED_EXTENSIONS>' -- npx -y @wwwwwujl/yuque-mcp@1.1.0
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "yuque-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@wwwwwujl/yuque-mcp@1.1.0"
            ],
            "env": {
                "YUQUE_TOKEN": "<your yuque_token>",
                "YUQUE_ENDPOINT": "<YUQUE_ENDPOINT>",
                "YUQUE_TIMEOUT_MS": "<YUQUE_TIMEOUT_MS>",
                "YUQUE_MAX_RETRIES": "<YUQUE_MAX_RETRIES>",
                "YUQUE_ALLOW_WRITE": "<YUQUE_ALLOW_WRITE>",
                "YUQUE_WRITE_NAMESPACE_ALLOWLIST": "<YUQUE_WRITE_NAMESPACE_ALLOWLIST>",
                "YUQUE_WRITE_GROUP_ALLOWLIST": "<YUQUE_WRITE_GROUP_ALLOWLIST>",
                "YUQUE_ALLOW_DELETE": "<YUQUE_ALLOW_DELETE>",
                "YUQUE_DELETE_NAMESPACE_ALLOWLIST": "<YUQUE_DELETE_NAMESPACE_ALLOWLIST>",
                "YUQUE_FILE_ROOT": "<YUQUE_FILE_ROOT>",
                "YUQUE_FILE_MAX_BYTES": "<YUQUE_FILE_MAX_BYTES>",
                "YUQUE_FILE_ALLOWED_EXTENSIONS": "<YUQUE_FILE_ALLOWED_EXTENSIONS>"
            }
        }
    }
}

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

  • YUQUE_TOKEN إلزامي سري Yuque API token
  • YUQUE_ENDPOINT Yuque API endpoint (optional)
  • YUQUE_TIMEOUT_MS Yuque API timeout in milliseconds (optional)
  • YUQUE_MAX_RETRIES Read-only retry count (optional)
  • YUQUE_ALLOW_WRITE Enable write tools when true (optional, default false)
  • YUQUE_WRITE_NAMESPACE_ALLOWLIST Comma-separated namespace allowlist for repo/doc/toc writes (optional)
  • YUQUE_WRITE_GROUP_ALLOWLIST Comma-separated group login allowlist for group writes (optional)
  • YUQUE_ALLOW_DELETE Enable delete tools when true (optional, default false)
  • YUQUE_DELETE_NAMESPACE_ALLOWLIST Comma-separated delete allowlist targets (optional)
  • YUQUE_FILE_ROOT Allowed root directory for file-based doc tools (optional, default current working directory)
  • YUQUE_FILE_MAX_BYTES Maximum size for file-based doc tools (optional, default 1048576)
  • YUQUE_FILE_ALLOWED_EXTENSIONS Comma-separated allowed extensions for file-based doc tools (optional, default .md,.markdown,.txt)

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

ما هو Yuque MCP؟

Yuque MCP server with safe read/write tools for groups, group members, repositories, docs, and TOC.

كيف أثبّت Yuque MCP؟

يعمل على جهازك. في Claude Code: claude mcp add yuque-mcp -e 'YUQUE_TOKEN=<your yuque_token>' -e 'YUQUE_ENDPOINT=<YUQUE_ENDPOINT>' -e 'YUQUE_TIMEOUT_MS=<YUQUE_TIMEOUT_MS>' -e 'YUQUE_MAX_RETRIES=<YUQUE_MAX_RETRIES>' -e 'YUQUE_ALLOW_WRITE=<YUQUE_ALLOW_WRITE>' -e 'YUQUE_WRITE_NAMESPACE_ALLOWLIST=<YUQUE_WRITE_NAMESPACE_ALLOWLIST>' -e 'YUQUE_WRITE_GROUP_ALLOWLIST=<YUQUE_WRITE_GROUP_ALLOWLIST>' -e 'YUQUE_ALLOW_DELETE=<YUQUE_ALLOW_DELETE>' -e 'YUQUE_DELETE_NAMESPACE_ALLOWLIST=<YUQUE_DELETE_NAMESPACE_ALLOWLIST>' -e 'YUQUE_FILE_ROOT=<YUQUE_FILE_ROOT>' -e 'YUQUE_FILE_MAX_BYTES=<YUQUE_FILE_MAX_BYTES>' -e 'YUQUE_FILE_ALLOWED_EXTENSIONS=<YUQUE_FILE_ALLOWED_EXTENSIONS>' -- npx -y @wwwwwujl/yuque-mcp@1.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

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

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

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

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

من يصون Yuque MCP؟

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

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