1. Conduid
  2. Commerce
  3. io.github.yuque/yuque-mcp
MCP server · Commerce

io.github.yuque/yuque-mcp

· github.com/yuque/yuque-mcp-server

MCP server for Yuque — expose your knowledge base to AI assistants.

Unclaimed commerce
InstallView source
37Low

Scored 6 months ago · breakdown

About io.github.yuque/yuque-mcp

io.github.yuque/yuque-mcp is an MCP server in the Commerce category: mCP server for Yuque — expose your knowledge base to AI assistants.

Install

Claude Code
claude mcp add io-github-yuque-yuque-mcp -- npx -y yuque-mcp
npx
npx -y yuque-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (7)

**Boards**`yuque_get_resource`

Parameters not published.

**Books**`yuque_list_books`

Parameters not published.

**Docs**`yuque_list_docs`

Parameters not published.

**Notes**`yuque_list_notes`

Parameters not published.

**Search**`yuque_search`

Parameters not published.

**TOC**`yuque_get_toc`

Parameters not published.

**User**`yuque_get_user`

Parameters not published.

Ask AI

✦

Ask AI about io.github.yuque/yuque-mcp

Powered by Claude · Grounded in docs

I know everything about io.github.yuque/yuque-mcp. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

Yuque MCP Server

CI npm version

MCP server for Yuque (语雀) — expose your knowledge base to AI assistants through the Model Context Protocol.

🌐 Website · 📖 API Docs · 中文文档

Quick Start

1. Get Your Yuque API Token

Visit Yuque Developer Settings to create a personal access token.

2. Quick Install (Recommended)

Use the built-in CLI to auto-configure your MCP client in one command:

npx yuque-mcp install --token=YOUR_TOKEN --client=cursor

Supported clients: claude-desktop, vscode, cursor, windsurf, cline, trae, qoder, opencode

Or use the interactive setup wizard:

npx yuque-mcp setup

The CLI will automatically find the correct config file for your OS, merge with any existing configuration (without overwriting other servers), and print a success message.

3. Manual Configuration

Choose your preferred client below:

claude mcp add yuque-mcp -- npx -y yuque-mcp --token=YOUR_TOKEN

Or using environment variables:

export YUQUE_PERSONAL_TOKEN=YOUR_TOKEN
claude mcp add yuque-mcp -- npx -y yuque-mcp

Add to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "yuque": {
      "command": "npx",
      "args": ["-y", "yuque-mcp"],
      "env": {
        "YUQUE_PERSONAL_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "yuque": {
      "command": "npx",
      "args": ["-y", "yuque-mcp"],
      "env": {
        "YUQUE_PERSONAL_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Then enable Agent mode in GitHub Copilot Chat.

Add to your Cursor MCP configuration (~/.cursor/mcp.json):

{
  "mcpServers": {
    "yuque": {
      "command": "npx",
      "args": ["-y", "yuque-mcp"],
      "env": {
        "YUQUE_PERSONAL_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Add to your Windsurf MCP configuration (~/.windsurf/mcp.json):

{
  "mcpServers": {
    "yuque": {
      "command": "npx",
      "args": ["-y", "yuque-mcp"],
      "env": {
        "YUQUE_PERSONAL_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Add to your Cline MCP settings (~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json):

{
  "mcpServers": {
    "yuque": {
      "command": "npx",
      "args": ["-y", "yuque-mcp"],
      "env": {
        "YUQUE_PERSONAL_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

In Trae, open Settings and navigate to the MCP section, then add a new stdio-type MCP Server with the following configuration:

  • Command: npx
  • Args: -y yuque-mcp
  • Env: YUQUE_PERSONAL_TOKEN=YOUR_TOKEN

See Trae MCP documentation for detailed instructions.

More clients: Any MCP-compatible client that supports stdio transport can use yuque-mcp. The general pattern is: command = npx, args = ["-y", "yuque-mcp"], env = YUQUE_PERSONAL_TOKEN.

4. Done!

Ask your AI assistant to search your Yuque docs, create documents, or manage books.

Authentication

The server supports multiple ways to provide your Yuque API token:

Method Environment Variable / Flag Description
Personal Token (recommended) YUQUE_PERSONAL_TOKEN For accessing your personal Yuque account
CLI Argument --token=YOUR_TOKEN Pass directly as a command-line argument

Priority order: YUQUE_PERSONAL_TOKEN > --token

Available Tools (16)

Category Tools
User yuque_get_user
Search yuque_search
Books yuque_list_books, yuque_get_book, yuque_create_book, yuque_update_book
Docs yuque_list_docs, yuque_get_doc, yuque_create_doc, yuque_update_doc
TOC yuque_get_toc, yuque_update_toc
Notes yuque_list_notes, yuque_get_note, yuque_create_note, yuque_update_note

Troubleshooting

Error Solution
YUQUE_PERSONAL_TOKEN is required Set the environment variable YUQUE_PERSONAL_TOKEN or pass --token=YOUR_TOKEN
401 Unauthorized Token is invalid or expired — regenerate at Yuque Settings
429 Rate Limited Too many requests — wait a moment and retry
410 Gone The resource has been permanently deleted or the API endpoint is deprecated — verify the target document/repo still exists
Tool not found Update to the latest version: npx -y yuque-mcp@latest
npx command not found Install Node.js (v18 or later)

Development

git clone https://github.com/yuque/yuque-mcp-server.git
cd yuque-mcp-server
npm install
npm test              # run tests
npm run build         # compile TypeScript
npm run dev           # dev mode with hot reload

Links

License

MIT

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About io.github.yuque/yuque-mcp

How do I install io.github.yuque/yuque-mcp?

Run claude mcp add io-github-yuque-yuque-mcp -- npx -y yuque-mcp, then add the server to your MCP client's configuration.

Is io.github.yuque/yuque-mcp safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.yuque/yuque-mcp still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.