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)```bash
npm install -g yuque-mcp-server
### Local Installation```bash
npm install yuque-mcp-server
From Source```bash
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```bash
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:```bash
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:```json
{
"mcpServers": {
"yuque": {
"command": "yuque-mcp-server",
"env": {
"YUQUE_TOKEN": "your_yuque_api_token_here"
}
}
}
}
Local Development Setup
For development from source:```json
{
"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
## 开发```bash
# 开发模式
npm run dev
# 构建
npm run build
许可证
MIT