Skip to main content
Glama

Yuque MCP Server

🎉 语雀MCP服务器

A Model Context Protocol (MCP) server that provides seamless integration with Yuque (语雀), a popular Chinese documentation platform. Enables AI assistants to manage Yuque content through a standardized MCP interface.

✨ Features

📚 Knowledge Base Management

  • List and create knowledge repositories

  • Manage repository settings and visibility

📄 Document Operations

  • Create, read, update, delete documents

  • Support for Markdown, Lake, and HTML formats

  • Advanced document search functionality

🔍 Search & Discovery

  • Global and repository-specific search

  • Intelligent query handling

📦 Installation

Global Installation (Recommended)

npm install -g yuque-mcp-server

Local Installation

npm install yuque-mcp-server

From Source

git clone https://github.com/tanis2010/yuque-mcp-server.git cd yuque-mcp-server npm install npm run build npm link

🔧 Configuration

1. Get Your Yuque API Token

  1. 登录语雀 (Log in to Yuque)

  2. 进入:账户设置 → 开发者设置 → API Token (Go to: Account Settings → Developer Settings → API Token)

  3. 创建新的Token并复制 (Create new Token and copy it)

2. Set Environment Variable

export YUQUE_TOKEN="your_yuque_api_token_here"

🤖 Claude Code Integration

This MCP server is specifically designed to work with Claude Code. Here's the simplest way to set it up:

🚀 Quick Setup (Recommended)

Use the Claude Code CLI to automatically configure the MCP server:

# Install the package globally first npm install -g yuque-mcp-server # Add to Claude Code with automatic configuration claude mcp add -s local yuque yuque-mcp-server --env YUQUE_TOKEN=your_yuque_api_token_here

That's it! The claude mcp add command will:

  • Automatically configure the MCP server in your Claude Code settings

  • Handle the environment variable securely

  • Set up the proper command structure

Manual Configuration (Alternative)

If you prefer manual configuration, you can edit ~/.claude/settings.json directly:

{ "mcpServers": { "yuque": { "command": "yuque-mcp-server", "env": { "YUQUE_TOKEN": "your_yuque_api_token_here" } } } }

Local Development Setup

For development from source:

{ "mcpServers": { "yuque": { "command": "node", "args": ["path/to/yuque-mcp-server/dist/server.js"], "env": { "YUQUE_TOKEN": "your_yuque_api_token_here" } } } }

Verify Installation

After setup, restart Claude Code and you should see these Yuque tools available:

  • yuque_get_user - Get current user information

  • yuque_get_repos - List knowledge repositories

  • yuque_get_docs - List documents in a repository

  • yuque_get_doc - Get document details

  • yuque_create_doc - Create new document

  • yuque_update_doc - Update existing document

  • yuque_delete_doc - Delete document

  • yuque_search_docs - Search documents

API工具

该MCP服务器提供以下工具:

yuque_get_user

获取当前用户信息

yuque_get_repos

获取知识库列表

  • userId (可选): 用户ID

yuque_get_docs

获取文档列表

  • repoId (必需): 知识库ID

  • limit (可选): 返回数量限制

  • offset (可选): 偏移量

yuque_get_doc

获取文档详情

  • docId (必需): 文档ID

yuque_create_doc

创建新文档

  • repoId (必需): 知识库ID

  • title (必需): 文档标题

  • content (必需): 文档内容

  • format (可选): 文档格式 (markdown/lake/html)

yuque_update_doc

更新文档

  • docId (必需): 文档ID

  • title (可选): 文档标题

  • content (可选): 文档内容

  • format (可选): 文档格式

yuque_delete_doc

删除文档

  • docId (必需): 文档ID

yuque_search_docs

搜索文档

  • query (必需): 搜索关键词

  • repoId (可选): 知识库ID

开发

# 开发模式 npm run dev # 构建 npm run build

许可证

MIT

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tanis2010/yuque-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server