yuque-mcp 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2025-02-15
+
+### Added
+- Initial release of Yuque MCP Server
+- 25 tools covering Yuque API (user, repo, doc, toc, search, group, stats, version)
+- Stdio transport for local MCP clients (Claude Desktop, Cursor, Claude Code)
+- TypeScript implementation with strict mode
+- Zod-based parameter validation for all tools
+- AI-optimized response formatting (minimal token usage)
+- Authentication via `YUQUE_TOKEN` environment variable or `--token` CLI argument
+- Comprehensive test suite with vitest
+- ESLint + Prettier code quality tooling
+- CI pipeline (Node 18/20/22)
+- Docker support
+- Documentation in English and Chinese
+
+[Unreleased]: https://github.com/chen201724/yuque-mcp-server/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/chen201724/yuque-mcp-server/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cwg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,215 @@
+# Yuque MCP Server
+
+[![CI](https://github.com/chen201724/yuque-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/chen201724/yuque-mcp-server/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
+[![MCP](https://img.shields.io/badge/MCP-1.0-green.svg)](https://modelcontextprotocol.io/)
+
+MCP server for [Yuque (语雀)](https://www.yuque.com/) — expose your Yuque knowledge base to AI assistants through the [Model Context Protocol](https://modelcontextprotocol.io/).
+
+[中文文档](./README.zh-CN.md)
+
+## Features
+
+- **25 Tools** — Complete coverage of Yuque API (docs, repos, search, groups, stats, TOC, versions)
+- **Stdio Transport** — Works with Claude Desktop, Cursor, Claude Code, Windsurf, and any MCP-compatible client
+- **Type-Safe** — Full TypeScript with strict mode + Zod parameter validation
+- **AI-Optimized** — Response formatting designed to minimize token usage
+- **Well-Tested** — Unit tests with vitest, CI on Node 18/20/22
+
+## Quick Start
+
+### 1. Get Your Yuque API Token
+
+Visit [Yuque Developer Settings](https://www.yuque.com/settings/tokens) to generate a personal API token.
+
+### 2. Configure Your MCP Client
+
+#### Claude Code
+
+```bash
+claude mcp add yuque -- npx -y yuque-mcp --token=YOUR_TOKEN
+```
+
+Or add to `~/.claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "yuque": {
+      "command": "npx",
+      "args": ["-y", "yuque-mcp"],
+      "env": {
+        "YUQUE_TOKEN": "YOUR_TOKEN"
+      }
+    }
+  }
+}
+```
+
+#### Claude Desktop
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "yuque": {
+      "command": "npx",
+      "args": ["-y", "yuque-mcp"],
+      "env": {
+        "YUQUE_TOKEN": "YOUR_TOKEN"
+      }
+    }
+  }
+}
+```
+
+#### Cursor
+
+Add to `.cursor/mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "yuque": {
+      "command": "npx",
+      "args": ["-y", "yuque-mcp"],
+      "env": {
+        "YUQUE_TOKEN": "YOUR_TOKEN"
+      }
+    }
+  }
+}
+```
+
+#### Global Install (alternative)
+
+```bash
+npm install -g yuque-mcp
+export YUQUE_TOKEN=your_token_here
+yuque-mcp
+```
+
+## Available Tools
+
+| Category | Tool | Description |
+|----------|------|-------------|
+| **User** | `yuque_get_user` | Get current user info |
+| **User** | `yuque_list_groups` | List user's groups/teams |
+| **Search** | `yuque_search` | Search docs, repos, or users |
+| **Repos** | `yuque_list_repos` | List repos for user or group |
+| **Repos** | `yuque_get_repo` | Get repo details |
+| **Repos** | `yuque_create_repo` | Create new repo |
+| **Repos** | `yuque_update_repo` | Update repo settings |
+| **Repos** | `yuque_delete_repo` | Delete repo |
+| **Docs** | `yuque_list_docs` | List documents in repo |
+| **Docs** | `yuque_get_doc` | Get document with full content |
+| **Docs** | `yuque_create_doc` | Create new document |
+| **Docs** | `yuque_update_doc` | Update document |
+| **Docs** | `yuque_delete_doc` | Delete document |
+| **TOC** | `yuque_get_toc` | Get repo table of contents |
+| **TOC** | `yuque_update_toc` | Update repo TOC |
+| **Versions** | `yuque_list_doc_versions` | List document versions |
+| **Versions** | `yuque_get_doc_version` | Get specific version |
+| **Groups** | `yuque_list_group_members` | List group members |
+| **Groups** | `yuque_update_group_member` | Update member role |
+| **Groups** | `yuque_remove_group_member` | Remove member |
+| **Stats** | `yuque_group_stats` | Group statistics |
+| **Stats** | `yuque_group_member_stats` | Member statistics |
+| **Stats** | `yuque_group_book_stats` | Book statistics |
+| **Stats** | `yuque_group_doc_stats` | Document statistics |
+| **Utility** | `yuque_hello` | Test API connectivity |
+
+## Docker
+
+```bash
+docker build -t yuque-mcp .
+docker run --rm -i -e YUQUE_TOKEN=your_token yuque-mcp
+```
+
+MCP client config with Docker:
+
+```json
+{
+  "mcpServers": {
+    "yuque": {
+      "command": "docker",
+      "args": ["run", "--rm", "-i", "-e", "YUQUE_TOKEN", "yuque-mcp"],
+      "env": {
+        "YUQUE_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+## Development
+
+```bash
+git clone https://github.com/chen201724/yuque-mcp-server.git
+cd yuque-mcp-server
+npm install
+npm test              # run tests
+npm run test:coverage # with coverage
+npm run build         # compile TypeScript
+npm run dev           # dev mode with hot reload
+npm run lint          # lint
+npm run format        # format
+```
+
+## Architecture
+
+```
+src/
+├── cli.ts                — CLI entry (stdio transport)
+├── index.ts              — HTTP entry (self-hosted, optional)
+├── server.ts             — MCP server core
+├── tools/                — Tool implementations (25 tools)
+│   ├── user.ts           — User & group listing
+│   ├── repo.ts           — Repository CRUD
+│   ├── doc.ts            — Document CRUD
+│   ├── toc.ts            — Table of contents
+│   ├── search.ts         — Full-text search
+│   ├── group.ts          — Group member management
+│   ├── stats.ts          — Analytics & statistics
+│   └── version.ts        — Document version history
+├── services/
+│   ├── yuque-client.ts   — Yuque API HTTP client
+│   └── types.ts          — Type definitions
+└── utils/
+    ├── format.ts         — AI-optimized response formatting
+    └── error.ts          — Error handling & user-friendly messages
+```
+
+## Troubleshooting
+
+**"YUQUE_TOKEN is required"**
+Set the token via environment variable or `--token` argument. Get yours at [Yuque Settings](https://www.yuque.com/settings/tokens).
+
+**"Request failed with status 401"**
+Your token is invalid or expired. Generate a new one from Yuque settings.
+
+**"Request failed with status 429"**
+Rate limited by Yuque API. Wait a moment and retry.
+
+**Tool not found**
+Make sure you're using the latest version: `npx -y yuque-mcp@latest`
+
+## Contributing
+
+Contributions welcome! Please see [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+## Security
+
+For security issues, see [SECURITY.md](./SECURITY.md).
+
+## License
+
+[MIT](./LICENSE)
+
+## Links
+
+- [Yuque API Documentation](https://www.yuque.com/yuque/developer/api)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)

package/README.zh-CN.md

@@ -0,0 +1,231 @@
+# 语雀 MCP 服务器
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
+[![MCP](https://img.shields.io/badge/MCP-1.0-green.svg)](https://modelcontextprotocol.io/)
+
+语雀 API 的官方品质 MCP (Model Context Protocol) 服务器。该服务器通过标准化的 MCP 接口向 AI 助手暴露语雀的知识库能力。
+
+[English Documentation](./README.md)
+
+## 特性
+
+- **完整 API 覆盖**：实现了全部 25 个语雀 API 端点
+- **双传输模式**：支持 stdio 和 streamable-http 两种传输方式
+- **类型安全**：完整的 TypeScript 实现，启用严格模式
+- **AI 优化**：响应格式设计旨在最小化 token 使用
+- **灵活认证**：支持环境变量或 CLI 参数认证
+- **完善测试**：使用 vitest 进行全面测试覆盖
+- **生产就绪**：遵循 Ant Design 开源标准
+
+## 安装
+
+```bash
+npm install -g yuque-mcp
+```
+
+或直接使用 npx:
+
+```bash
+npx yuque-mcp --token=YOUR_TOKEN
+```
+
+## 快速开始
+
+### 1. 获取语雀 API Token
+
+访问 [语雀设置](https://www.yuque.com/settings/tokens) 生成你的 API token。
+
+### 2. 运行服务器
+
+**Stdio 模式（用于 MCP 客户端）：**
+
+```bash
+export YUQUE_TOKEN=your_token_here
+yuque-mcp
+```
+
+或使用 CLI 参数:
+
+```bash
+yuque-mcp --token=your_token_here
+```
+
+**HTTP 模式（用于测试）：**
+
+```bash
+export YUQUE_TOKEN=your_token_here
+npm start
+```
+
+服务器默认运行在 `http://localhost:3000`。
+
+## 可用工具
+
+### 用户与团队 (2 个工具)
+- `yuque_get_user` - 获取当前用户信息
+- `yuque_list_groups` - 列出用户的团队
+
+### 搜索 (1 个工具)
+- `yuque_search` - 搜索文档、知识库或用户
+
+### 知识库 (5 个工具)
+- `yuque_list_repos` - 列出用户或团队的知识库
+- `yuque_get_repo` - 获取知识库详情
+- `yuque_create_repo` - 创建新知识库
+- `yuque_update_repo` - 更新知识库
+- `yuque_delete_repo` - 删除知识库
+
+### 文档 (5 个工具)
+- `yuque_list_docs` - 列出知识库中的文档
+- `yuque_get_doc` - 获取文档完整内容
+- `yuque_create_doc` - 创建新文档
+- `yuque_update_doc` - 更新文档
+- `yuque_delete_doc` - 删除文档
+
+### 目录 (2 个工具)
+- `yuque_get_toc` - 获取知识库目录
+- `yuque_update_toc` - 更新知识库目录
+
+### 文档版本 (2 个工具)
+- `yuque_list_doc_versions` - 列出文档版本
+- `yuque_get_doc_version` - 获取特定版本
+
+### 团队管理 (3 个工具)
+- `yuque_list_group_members` - 列出团队成员
+- `yuque_update_group_member` - 更新成员角色
+- `yuque_remove_group_member` - 移除成员
+
+### 统计 (4 个工具)
+- `yuque_group_stats` - 团队统计
+- `yuque_group_member_stats` - 成员统计
+- `yuque_group_book_stats` - 知识库统计
+- `yuque_group_doc_stats` - 文档统计
+
+### 工具 (1 个工具)
+- `yuque_hello` - 测试 API 连接
+
+## Docker
+
+```bash
+# 构建镜像
+docker build -t yuque-mcp .
+
+# 运行（stdio 模式）
+docker run --rm -i -e YUQUE_TOKEN=your_token yuque-mcp
+```
+
+Docker 方式的 MCP 客户端配置：
+
+```json
+{
+  "mcpServers": {
+    "yuque": {
+      "command": "docker",
+      "args": ["run", "--rm", "-i", "-e", "YUQUE_TOKEN", "yuque-mcp"],
+      "env": {
+        "YUQUE_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+## 配置
+
+### 环境变量
+
+- `YUQUE_TOKEN` - 你的语雀 API token（必需）
+- `PORT` - HTTP 服务器端口（默认：3000，仅 HTTP 模式）
+
+### MCP 客户端配置
+
+添加到你的 MCP 客户端配置（例如 Claude Desktop）：
+
+```json
+{
+  "mcpServers": {
+    "yuque": {
+      "command": "yuque-mcp",
+      "env": {
+        "YUQUE_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+## 开发
+
+```bash
+# 克隆仓库
+git clone https://github.com/chen201724/yuque-mcp-server.git
+cd yuque-mcp-server
+
+# 安装依赖
+npm install
+
+# 运行测试
+npm test
+
+# 运行测试覆盖率
+npm run test:coverage
+
+# 构建
+npm run build
+
+# 开发模式（热重载）
+npm run dev
+
+# 代码检查
+npm run lint
+
+# 代码格式化
+npm run format
+```
+
+## 架构
+
+```
+src/
+├── index.ts              — HTTP 服务器入口
+├── cli.ts                — CLI 入口（stdio）
+├── server.ts             — MCP 服务器核心
+├── tools/                — 工具实现（按领域划分）
+│   ├── user.ts
+│   ├── repo.ts
+│   ├── doc.ts
+│   ├── toc.ts
+│   ├── search.ts
+│   ├── group.ts
+│   ├── stats.ts
+│   └── version.ts
+├── services/
+│   ├── yuque-client.ts   — 语雀 API 客户端
+│   └── types.ts          — 类型定义
+└── utils/
+    ├── format.ts         — 响应格式化
+    └── error.ts          — 错误处理
+```
+
+## 贡献
+
+我们欢迎贡献！详情请参阅 [CONTRIBUTING.md](./CONTRIBUTING.md)。
+
+## 安全
+
+安全问题请参阅 [SECURITY.md](./SECURITY.md)。
+
+## 许可证
+
+[MIT](./LICENSE)
+
+## 链接
+
+- [语雀 API 文档](https://www.yuque.com/yuque/developer/api)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+- [语雀官网](https://www.yuque.com/)
+
+## 致谢
+
+本项目受 [Notion MCP Server](https://github.com/makenotion/notion-mcp-server) 启发，遵循 Ant Design 开源标准。

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { runStdioServer } from './server.js';
+const token = process.env.YUQUE_TOKEN || process.argv.find((arg) => arg.startsWith('--token='))?.split('=')[1];
+if (!token) {
+    console.error('Error: YUQUE_TOKEN environment variable or --token argument is required');
+    process.exit(1);
+}
+runStdioServer(token).catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAE/G,IAAI,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,CAAC,KAAK,CAAC,yEAAyE,CAAC,CAAC;IACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,cAAc,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACpC,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,30 @@
+import { createServer as createMCPServer } from './server.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { createServer } from 'node:http';
+import { randomUUID } from 'node:crypto';
+const token = process.env.YUQUE_TOKEN;
+if (!token) {
+    console.error('Error: YUQUE_TOKEN environment variable is required');
+    process.exit(1);
+}
+const mcpServer = createMCPServer(token);
+const transport = new StreamableHTTPServerTransport({
+    sessionIdGenerator: () => randomUUID(),
+});
+mcpServer.connect(transport).then(() => {
+    const port = Number(process.env.PORT) || 3000;
+    const httpServer = createServer((req, res) => {
+        transport.handleRequest(req, res).catch((error) => {
+            console.error('Request handling error:', error);
+            res.statusCode = 500;
+            res.end('Internal Server Error');
+        });
+    });
+    httpServer.listen(port, () => {
+        console.log(`Yuque MCP Server running on http://localhost:${port}`);
+    });
+}).catch((error) => {
+    console.error('Failed to start server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;AAEtC,IAAI,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;AACzC,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;IAClD,kBAAkB,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE;CACvC,CAAC,CAAC;AAEH,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IAC9C,MAAM,UAAU,GAAG,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC3C,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAChD,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;YAChD,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QAC3B,OAAO,CAAC,GAAG,CAAC,gDAAgD,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,37 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export declare function createServer(token: string): Server<{
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+        progressToken?: string | number | undefined;
+        "io.modelcontextprotocol/related-task"?: {
+            taskId: string;
+        } | undefined;
+    } | undefined;
+}>;
+export declare function runStdioServer(token: string): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAgBnE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DzC;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,iBAKjD"}

package/dist/server.js

@@ -0,0 +1,72 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { YuqueClient } from './services/yuque-client.js';
+import { userTools } from './tools/user.js';
+import { repoTools } from './tools/repo.js';
+import { docTools } from './tools/doc.js';
+import { tocTools } from './tools/toc.js';
+import { searchTools } from './tools/search.js';
+import { groupTools } from './tools/group.js';
+import { statsTools } from './tools/stats.js';
+import { versionTools } from './tools/version.js';
+export function createServer(token) {
+    const client = new YuqueClient(token);
+    const server = new Server({
+        name: 'yuque-mcp',
+        version: '0.1.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Combine all tools
+    const allTools = {
+        ...userTools,
+        ...repoTools,
+        ...docTools,
+        ...tocTools,
+        ...searchTools,
+        ...groupTools,
+        ...statsTools,
+        ...versionTools,
+    };
+    // Register list_tools handler
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: Object.entries(allTools).map(([name, tool]) => ({
+                name,
+                description: tool.description,
+                inputSchema: tool.inputSchema,
+            })),
+        };
+    });
+    // Register call_tool handler
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const toolName = request.params.name;
+        const tool = allTools[toolName];
+        if (!tool) {
+            throw new Error(`Unknown tool: ${toolName}`);
+        }
+        try {
+            // Validate arguments with zod
+            const args = tool.inputSchema.parse(request.params.arguments);
+            // Call the tool handler
+            return await tool.handler(client, args);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Tool execution failed: ${error.message}`);
+            }
+            throw error;
+        }
+    });
+    return server;
+}
+export async function runStdioServer(token) {
+    const server = createServer(token);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('Yuque MCP Server running on stdio');
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}