Overview
Yuque MCP Server is a Model-Context-Protocol (MCP) server designed for integrating with Yuque's API, enabling AI models to interact with Yuque's knowledge base platform.
To use the Yuque MCP Server, clone the repository, install dependencies, set up your environment variables, and run the server in either development or production mode. You can also deploy it using Docker.
- Fetch user and document information from Yuque - Create, read, update, and delete documents - Search content within Yuque - Retrieve repository information - Integration with AI models using the Model-Context-Protocol
- Automating document management in Yuque
- Enabling AI models to access and manipulate knowledge base content
- Facilitating collaborative documentation processes
Add to your AI client
Use these steps to connect GitHub Actions 工作流使用说明 in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"yuque-mcp-server-henryhaoson": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-yuque-mcp-server-henryhaoson"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"yuque-mcp-server-henryhaoson": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-yuque-mcp-server-henryhaoson"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"yuque-mcp-server-henryhaoson": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-yuque-mcp-server-henryhaoson"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"yuque-mcp-server-henryhaoson": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-yuque-mcp-server-henryhaoson"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"yuque-mcp-server-henryhaoson": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-yuque-mcp-server-henryhaoson"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"yuque-mcp-server-henryhaoson": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-yuque-mcp-server-henryhaoson"
]
}
}
}FAQ
What are the prerequisites for using Yuque MCP Server?
You need Node.js 18+ and a Yuque account with an API token.
Can I deploy Yuque MCP Server using Docker?
Yes! The project provides Docker support for easy deployment.
How can I add new tools to the server?
You can add new tools by modifying the `registerTools` method in the server implementation.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2235,"uuid":"9cf7752f-0188-4f45-b857-800f7888c0fc","name":"Yuque-MCP-Server","title":"GitHub Actions 工作流使用说明","description":"Yuque mcp server","avatar_url":"https://avatars.githubusercontent.com/u/22147654?v=4","created_at":"2025-03-09T04:27:33.223Z","updated_at":"2025-03-12T10:20:31.490Z","status":"created","author_name":"HenryHaoson","author_avatar_url":"https://avatars.githubusercontent.com/u/22147654?v=4","tags":"mcp,yuque,yuque-mcp","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/HenryHaoson/Yuque-MCP-Server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"12\",\"license\":\"\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-04-22 11:47:59\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]