SETUP_GUIDE.md•2.56 kB
# Yuque MCP Server v1.1.0 - 安装和配置指南
## 🎉 恭喜!Yuque MCP Server 已成功安装和配置
### 📦 当前状态
- ✅ **版本**: v1.1.0 (包含所有API修复和新功能)
- ✅ **全局安装**: 已完成
- ✅ **Claude配置**: 已自动配置
- ✅ **环境变量**: 已设置
### 🔧 完成设置的最后步骤
#### 1. 配置您的语雀API令牌
编辑配置文件:`C:\Users\admin\.claude\mcp_settings.json`
将:
```json
"YUQUE_TOKEN": "请在这里设置您的语雀API令牌"
```
替换为:
```json
"YUQUE_TOKEN": "您的实际语雀API令牌"
```
**获取语雀API令牌:**
1. 登录语雀
2. 进入:账户设置 → 开发者设置 → API Token
3. 创建新的Token并复制
4. 粘贴到配置文件中
#### 2. 重启Claude应用
- 完全关闭Claude应用
- 重新启动Claude以加载新的MCP配置
### 🚀 可用的MCP工具
现在您可以在Claude中使用以下工具:
#### 用户和知识库管理
- `yuque_get_user()` - 获取当前用户信息
- `yuque_get_repos(userId?)` - 获取知识库列表
- `yuque_create_repo(name, description?, isPublic?)` - 创建知识库
#### 文档管理
- `yuque_get_docs(repoId, limit?, offset?)` - 获取文档列表
- `yuque_get_doc(docId, repoId)` - 获取文档详情 ⚠️ *需要repoId*
- `yuque_create_doc(repoId, title, content, format?)` - 创建文档
- `yuque_update_doc(docId, repoId, title?, content?, format?)` - 更新文档 ⚠️ *需要repoId*
- `yuque_delete_doc(docId, repoId)` - 删除文档 ⚠️ *需要repoId*
#### 搜索功能
- `yuque_search_docs(query, repoId?)` - 搜索文档
### 📝 使用示例
在Claude中,您可以这样使用:
```
请帮我获取我的语雀知识库列表
```
```
请创建一个名为"2025年10月笔记"的公开知识库
```
```
请在知识库ID为12345中创建一个新文档,标题是"测试文档"
```
### ⚠️ 重要更新说明
**v1.1.0 主要变更:**
1. **修复了所有API端点问题**
2. **文档操作现在需要知识库ID (repoId)**
3. **新增了创建知识库功能**
4. **修复了搜索功能**
5. **100%的MCP工具测试通过**
### 🆘 故障排除
如果遇到问题:
1. **检查配置文件**:确保token正确设置
2. **重启Claude**:确保新配置被加载
3. **检查网络**:确保能访问语雀API
4. **查看日志**:检查Claude的错误信息
### 📞 支持
如有问题,请查看:
- 项目文档:README.md
- 问题反馈:GitHub Issues
- CLAUDE.md:开发者文档
---
🎉 **享受使用Yuque MCP Server v1.1.0!**