Yuque MCP Server

The Yuque MCP Server is a specialized bridge that lets AI assistants, such as Claude, tap directly into the Yuque knowledge‑base platform via the Model‑Context‑Protocol. It solves a common pain point for developers and knowledge managers: integrating rich, enterprise‑grade documentation systems into conversational AI workflows without writing custom API wrappers or handling authentication overhead. By exposing a set of well‑defined tools, the server allows an AI model to query user information, fetch and manipulate documents, search content, and pull detailed analytics—all in a single, consistent interface.

At its core, the server translates MCP tool calls into Yuque OpenAPI requests. This means a model can “ask” for the current user’s profile, list all documents in a repository, create a new Markdown page, or retrieve team‑level statistics. The server handles authentication via an API token supplied in the environment or as a query parameter, and it can be run over HTTP or as a CLI‑based stdio stream, giving flexibility for different deployment scenarios. Because each SSE connection can override configuration through query parameters, a single instance can serve multiple users or environments simultaneously—a useful feature for shared workspaces or testing.

Key capabilities include:

• User & Repository Management – retrieve user details, list personal or specified repositories, and enumerate documents within them.
• Document CRUD – create, read, update, or delete documents with support for Markdown, HTML, and Lake formats, plus fine‑grained permission controls.
• Search & Filtering – perform scoped searches across documents or repositories, filtering by author, date range, or content type.
• Analytics & Statistics – access team‑level metrics such as member counts, document volumes, read counts, and engagement statistics for repositories or individual documents.

Typical use cases span from automated documentation generation (e.g., an AI drafting a new product guide directly into Yuque) to real‑time analytics dashboards (e.g., an assistant summarizing team engagement metrics). Developers can embed the server into their existing AI toolchains, letting models read and modify knowledge bases on demand while maintaining compliance with Yuque’s security model.

What sets this MCP apart is its tight coupling to the official Yuque OpenAPI, ensuring that all tool outputs remain consistent with the platform’s data structures. The server also supports Docker and Smithery deployment, making it straightforward to spin up a production‑ready instance in any environment. For teams that rely on Yuque for internal knowledge sharing, the server provides a seamless, code‑free pathway to harness AI’s conversational power directly within their documentation ecosystem.