# Cherry Studio 配置指南

本文档介绍如何在 Cherry Studio 中配置和使用 DOCX 论文生成 MCP Server。

## 安装 MCP Server

### 方法一：直接安装（推荐）

```bash
pip install mcp-docx-thesis-server
```

### 方法二：从源码安装

```bash
git clone https://github.com/yourusername/mcp-docx-thesis-server.git
cd mcp-docx-thesis-server
pip install -e .
```

## Cherry Studio 配置

### 1. 打开 MCP 配置

1. 启动 Cherry Studio
2. 点击左下角的设置按钮（⚙️）
3. 选择 "MCP" 选项卡
4. 点击 "添加 MCP Server"

### 2. 添加 MCP Server

在 MCP 配置中添加以下内容：

```json
{
  "mcpServers": {
    "docx-thesis": {
      "command": "python",
      "args": ["-m", "mcp_docx_thesis_server.server"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

如果使用虚拟环境，请指定完整路径：

```json
{
  "mcpServers": {
    "docx-thesis": {
      "command": "/path/to/venv/bin/python",
      "args": ["-m", "mcp_docx_thesis_server.server"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

Windows 用户：

```json
{
  "mcpServers": {
    "docx-thesis": {
      "command": "C:\\path\\to\\venv\\Scripts\\python.exe",
      "args": ["-m", "mcp_docx_thesis_server.server"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

### 3. 验证配置

1. 保存配置
2. Cherry Studio 会自动连接 MCP Server
3. 在对话中可以看到可用的工具

## 使用示例

### 示例 1：生成中山大学论文

在 Cherry Studio 对话中输入：

```markdown
请帮我生成一篇中山大学的毕业论文，保存到 ~/thesis_sysu.docx

论文内容：
# 人工智能在教育领域的应用研究

## 摘要

本文研究了人工智能技术在高等教育中的应用现状和发展趋势，分析了人工智能对教学模式、学习方式和评估体系的影响，并提出了相应的对策建议。

## Abstract

This paper studies the application status and development trends of artificial intelligence technology in higher education, analyzes the impact of AI on teaching models, learning methods, and assessment systems, and proposes corresponding countermeasures and suggestions.

## 关键词

人工智能，高等教育，教学改革，智能评估

## Keywords

artificial intelligence, higher education, teaching reform, intelligent assessment

## 第一章 绪论

### 1.1 研究背景

随着人工智能技术的快速发展，教育领域正在经历深刻的变革。从智能辅导系统到自适应学习平台，人工智能技术正在改变传统的教学模式。

### 1.2 研究意义

本研究具有重要的理论意义和实践价值。理论上有助于丰富教育技术学的研究内容，实践上可为高校教学改革提供参考。

### 1.3 研究方法

本研究采用文献研究法、案例分析法和调查研究法相结合的方法。

## 第二章 人工智能教育应用概述

### 2.1 人工智能技术发展

人工智能技术经历了从符号主义到连接主义，再到深度学习的发展历程。

### 2.2 教育应用场景

人工智能在教育中的应用主要包括智能辅导、自动评估、学习分析等方面。

## 第三章 案例分析

### 3.1 案例选择

本研究选取了国内外典型的AI教育应用案例进行分析。

### 3.2 案例分析

通过对案例的深入分析，总结了成功经验和存在问题。

## 第四章 结论与建议

### 4.1 主要结论

人工智能技术在高等教育中的应用前景广阔，但也面临数据隐私、伦理等挑战。

### 4.2 对策建议

建议加强师资培训，完善数据治理，推进技术与教学的深度融合。

## 参考文献

[1] 张三, 李四. 人工智能教育应用研究[J]. 教育研究, 2024, 45(3): 78-89.
[2] Smith J, Johnson A. AI in Education: A Comprehensive Review[J]. Educational Technology Research, 2023, 71(2): 245-267.
[3] 王五. 智能教育系统的理论与实践[M]. 北京: 高等教育出版社, 2023.
[4] Brown K, et al. Machine Learning Applications in Higher Education[J]. Computers & Education, 2023, 189: 104785.
```

元数据：
- 作者：张明
- 学号：20211000001
- 学院：教育信息技术学院
- 专业：教育技术学
- 指导教师：李教授
- 日期：2025年3月

### 示例 2：生成华南师范大学论文

```markdown
请帮我生成一篇华南师范大学的毕业论文，保存到 ~/thesis_scnu.docx

使用 university="scnu" 参数

论文内容：
# 基于深度学习的图像识别研究

## 摘要

本文研究了深度学习在图像识别领域的应用...

[... 论文内容 ...]
```

### 示例 3：查看支持的大学

```
请列出所有支持的大学论文模板
```

AI 会调用 `list_universities` 工具返回支持的大学列表。

### 示例 4：查看格式详情

```
请查看中山大学的论文格式要求
```

AI 会调用 `get_university_format` 工具返回详细的格式信息。

## Markdown 格式规范

### 论文结构

```markdown
# 论文标题（一级标题）

## 摘要（二级标题）
中文摘要内容...

## Abstract（二级标题）
英文摘要内容...

## 关键词（二级标题）
关键词1, 关键词2, 关键词3

## Keywords（二级标题）
Keyword1, Keyword2, Keyword3

## 第一章 章标题（二级标题）

### 1.1 节标题（三级标题）
正文内容...

### 1.2 节标题（三级标题）
正文内容...

## 第二章 章标题（二级标题）
...

## 参考文献（二级标题）
[1] 作者. 文献标题[类型]. 出版信息, 年份.
[2] ...
```

### 格式说明

1. **标题层级**：使用 `#` 表示层级，`#` 为论文标题，`##` 为章标题，`###` 为节标题
2. **摘要**：必须包含 `## 摘要` 和 `## Abstract`（可选）
3. **关键词**：必须包含 `## 关键词` 和 `## Keywords`（可选）
4. **参考文献**：使用 `[序号]` 格式，支持 `[1]`、`1.` 等多种格式
5. **正文段落**：使用空行分隔段落

## 支持的大学模板

| 大学代码 | 大学名称 | 特点 |
|---------|---------|------|
| sysu | 中山大学 | 中英文摘要分页，封面包含完整信息 |
| scnu | 华南师范大学 | 中英文摘要连续排版 |
| generic | 通用格式 | 符合 GB/T 7713.1-2006 标准 |

## 常见问题

### Q1: MCP Server 连接失败怎么办？

1. 检查 Python 环境是否正确安装
2. 检查 `mcp-docx-thesis-server` 是否已安装
3. 检查配置中的 Python 路径是否正确
4. 查看 Cherry Studio 的日志信息

### Q2: 生成的文档格式不正确？

1. 检查 Markdown 格式是否符合规范
2. 确认使用了正确的大学代码
3. 查看该大学的格式要求详情

### Q3: 如何添加新的大学模板？

1. 在 `formats.py` 中添加新的格式定义
2. 参考现有的 `SYSU_FORMAT` 或 `SCNU_FORMAT`
3. 在 `FORMATS` 字典中注册新格式
4. 重新安装 MCP Server

### Q4: 支持哪些操作系统？

- Windows ✅
- macOS ✅
- Linux ✅

### Q5: 生成的文档可以用 Word 打开吗？

可以，生成的 `.docx` 文件完全兼容 Microsoft Word、WPS Office、LibreOffice 等主流办公软件。

## 故障排除

### 检查 MCP Server 状态

在终端中运行：

```bash
python -m mcp_docx_thesis_server.server
```

如果没有报错，说明 MCP Server 可以正常运行。

### 查看日志

Cherry Studio 的 MCP 日志通常位于：

- Windows: `%APPDATA%/Cherry Studio/logs/`
- macOS: `~/Library/Application Support/Cherry Studio/logs/`
- Linux: `~/.config/Cherry Studio/logs/`

### 重新安装

如果出现问题，可以尝试重新安装：

```bash
pip uninstall mcp-docx-thesis-server
pip install mcp-docx-thesis-server
```

## 更新日志

### v1.0.0

- 初始版本发布
- 支持中山大学、华南师范大学、通用格式
- 支持 Markdown 解析
- 支持自动生成目录
- 支持参考文献格式化
