# MCP DOCX Thesis Server

一个基于 MCP (Model Context Protocol) 的论文生成服务器，支持将 Markdown 格式的论文内容转换为符合高校格式要求的 DOCX 文档。

## 功能特性

- 支持多所高校论文模板（中山大学、华南师范大学等）
- 自动处理论文结构（封面、摘要、目录、正文、参考文献等）
- 支持 Markdown 格式输入
- 自动生成目录和页码
- 符合各高校格式规范的字体、字号、行距设置

## 支持的大学模板

| 大学 | 模板代码 | 状态 |
|------|----------|------|
| 中山大学 | `sysu` | ✅ 已支持 |
| 华南师范大学 | `scnu` | ✅ 已支持 |
| 通用模板 | `generic` | ✅ 已支持 |

## 安装

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

## 使用

### 在 Cherry Studio 中配置

1. 打开 Cherry Studio 设置
2. 进入 MCP 配置页面
3. 添加新的 MCP Server：

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

### 可用工具

#### 1. `generate_thesis`

生成标准格式的论文 DOCX 文件。

**参数：**
- `markdown_content` (string): 论文的 Markdown 内容
- `university` (string): 大学模板代码（如 `sysu`, `scnu`, `generic`）
- `output_path` (string): 输出文件路径
- `metadata` (object): 论文元数据
  - `title` (string): 论文标题
  - `author` (string): 作者姓名
  - `student_id` (string): 学号
  - `major` (string): 专业
  - `advisor` (string): 指导教师
  - `date` (string): 日期

**示例：**

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

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

## 摘要

本文研究了人工智能技术在高等教育中的应用...

## 第一章 绪论

### 1.1 研究背景

随着人工智能技术的快速发展...

## 参考文献

[1] 张三. 人工智能导论[M]. 北京: 清华大学出版社, 2024.
```

#### 2. `list_universities`

列出所有支持的大学模板。

#### 3. `get_university_format`

获取指定大学的格式要求详情。

**参数：**
- `university` (string): 大学模板代码

## 论文 Markdown 格式规范

```markdown
# 论文标题

## 摘要

中文摘要内容...

## Abstract

English abstract content...

## 关键词

关键词1, 关键词2, 关键词3

## Keywords

Keyword1, Keyword2, Keyword3

## 第一章 绪论

### 1.1 研究背景

正文内容...

### 1.2 研究意义

正文内容...

## 第二章 相关理论与技术

...

## 参考文献

[1] 作者. 文献标题[类型]. 出版信息, 年份.
```

## 开发

```bash
# 克隆仓库
git clone https://github.com/yourusername/mcp-docx-thesis-server.git
cd mcp-docx-thesis-server

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip install -e ".[dev]"

# 运行测试
pytest

# 代码格式化
black src/
ruff check src/

# 类型检查
mypy src/
```

## 许可证

MIT License
