Verified

Yuque MCP Server

Yuque knowledge base content management via Model Context Protocol integration.

Data last scanned today · Reviewed today

4519 tools★ 236TypeScriptMIT

Overview

Yuque MCP Server bridges your AI assistant with the Yuque knowledge base. It allows users to perform operations such as searching documentation, summarizing content, and creating new documents directly from within an MCP-compliant client environment.

Our verdict

This server carries a high-risk score of 40/100, primarily because the authentication method and read-only safety measures have not been editorially reviewed. It is a community-maintained project that requires an API token to function. Users should exercise caution and review the codebase before granting it access to sensitive documentation.

Small footprint with only 4 direct dependencies
Comprehensive setup documentation and CLI installation flow
Open source MIT licensed codebase

Authentication method has not undergone formal security review
Lacks verification for read-only mode safety
Maintained by community contributors rather than the official vendor

Setup

Claude Desktop

{
  "mcpServers": {
    "yuque-mcp-server": {
      "args": [
        "-y",
        "yuque-mcp"
      ],
      "command": "npx"
    }
  }
}

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.

No read-only mode — running this grants full read/write access.
No built-in authentication — anyone with access to this config can invoke every tool it exposes.

Tools

Tool	Description	Risk
yuque_get_user	Get the authenticated user for the current token	low
yuque_search	Search docs or repos, with paging	low
yuque_list_books	List books (知识库) of a user	low
yuque_get_book	Get a book by ID or namespace	low
yuque_create_book	Create a book	medium
yuque_update_book	Update name, slug, description, or visibility	medium
yuque_list_docs	List docs in a book, with paging	low
yuque_get_doc	Get full content — markdown, lake, or html	low
yuque_create_doc	Create a doc in a book	medium
yuque_update_doc	Update a doc's body or metadata	medium

Compatibility

Client	Local	Docker	Remote	Read-only
Claude Desktop
Cursor
VS Code
Windsurf
ChatGPT

Frequently asked questions

›What authentication is required to use the Yuque MCP server?

You must provide a Yuque API token, which can be generated via your Yuque Developer Settings.

›Do I need to provide a custom host address?

A custom host is only required if you are using a team token bound to a specific Yuque space or working with a private deployment.

›How can I install the server for supported MCP clients?

You can use the command 'npx yuque-mcp install --token=YOUR_TOKEN --client=CLIENT_NAME' to automatically update the configuration for supported clients like Cursor, Claude Desktop, or VS Code.

›Are there any limitations when updating documents?

When using the 'yuque_update_doc' tool, you cannot modify the document body and metadata, such as title or slug, in a single API call; these must be updated in separate requests.

›Can I use environment variables for configuration instead of CLI flags?

Yes, you can use 'YUQUE_TOKEN' and 'YUQUE_HOST' as environment variables, which the server will prioritize over CLI flags.