← Index

Yuque MCP

io.github.wwwwujl/yuque-mcp·v1.1.0·Documents & Spreadsheets
Quality Score
92
/100

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

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "yuque-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wwwwwujl/yuque-mcp"
      ],
      "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>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "yuque-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wwwwwujl/yuque-mcp"
      ],
      "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>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y @wwwwwujl/yuque-mcp
§02  Environment variables
YUQUE_TOKEN
requiredsecret

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)

§03  MCP Quality Score  ·  methodology
freshness
22
completeness
20
installability
25
documentation
15
stability
10
§04  Alternatives in Documents & Spreadsheets