edupaper-mcp
](https://www.npmjs.com/package/edupaper-mcp) 
edupaper-mcp 是一个基于 Model Context Protocol (MCP) 的试卷生成助手工具。 它可以帮助 AI 快速生成考试试卷，支持多种题型、Markdown 格式排版以及 LaTeX 数学公式渲染，最终输出为 DOCX 文档。
适用于：
- 🤖 与 AI 对话助手的集成（如 Claude Desktop、OpenAI MCP 客户端等）
- 🎓 教师或教育工作者快速出题
- 📝 自动化生成练习题
🚀 Features
- 📄 自动生成 DOCX 试卷：根据 JSON 输入自动排版并生成 Word 文档。
- 🎯 全题型支持：
- 单选题 (single_choice) - 多选题 (multiple_choice) - 判断题 (true_false) - 填空题 (fill_in_blank) - 名词解释 (noun_explanation) - 简答题 (short_answer) - 计算题 (calculation)
- 🧮 数学公式支持：完美支持 LaTeX 公式渲染（基于 Katex），支持行内公式 (
$E=mc^2$) 和块级公式 ($$...$$)。 - 📝 Markdown 排版：题目内容支持 Markdown 格式（粗体、斜体、列表等）。
- ✅ 答案解析：支持附带答案，自动显示在题目下方。
- ☁️ 临时链接生成：生成的试卷会自动上传并返回有效期为 7 天的下载链接。
📦 Installation & Usage
使用 npx 直接运行（无需安装）：
npx edupaper-mcp或者添加到你的 MCP 客户端配置中（如 claude_desktop_config.json）：
{
"mcpServers": {
"edupaper": {
"command": "npx",
"args": ["-y", "edupaper-mcp"]
}
}
}🛠️ Tool Definition
generate_exam_paper
生成一份包含指定题目的考试试卷 (DOCX)。
参数 (Parameters)
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
title | string | 是 | 试卷标题，显示在文档顶部。 |
questions | Array | 是 | 题目列表，具体结构见下文。 |
题目对象 (Question Object)
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
type | string | 是 | 题目类型（见下方枚举值）。 |
content | string | 是 | 题目内容，支持 Markdown 和 LaTeX 公式。 |
options | Array | 否 | 选项列表（仅用于选择题）。会自动添加 A/B/C/D 标签。 |
answer | string | 否 | 参考答案，将显示在题目下方。 |
points | number | 否 | 题目分值，显示为 (x分)。 |
支持的题型 (Question Types)
single_choice(单选题)multiple_choice(多选题)true_false(判断题)fill_in_blank(填空题)short_answer(简答题)noun_explanation(名词解释)calculation(计算题)
🧮 Math & Formatting Guide
本工具支持在题目内容 (content) 和选项 (options) 中使用 Markdown 和 LaTeX。
数学公式 (LaTeX)
- 行内公式：使用单美元符号包裹，例如
$E = mc^2$。 - 块级公式：使用双美元符号包裹，例如：
$$
\int_{0}^{\infty} x^2 dx
$$Markdown 格式
- 加粗：
**重点内容** - 斜体：
*斜体内容* - 代码：`
💡 Example Usage
以下是一个调用 generate_exam_paper 工具的 JSON 示例：
{
"title": "高中物理与数学联合测试",
"questions": [
{
"type": "single_choice",
"content": "已知质能方程 $E=mc^2$，其中 $c$ 代表什么？",
"options": [
"光速 (Speed of Light)",
"声速 (Speed of Sound)",
"电子速度 (Electron Speed)",
"地球公转速度 (Earth Revolution Speed)"
],
"points": 5,
"answer": "A"
},
{
"type": "calculation",
"content": "请计算以下定积分的值：\n$$ \\int_{0}^{\\pi} \\sin(x) dx $$",
"points": 10,
"answer": "2"
},
{
"type": "short_answer",
"content": "请简述 **牛顿第二定律** ($F=ma$) 的物理意义。",
"points": 10,
"answer": "物体加速度的大小跟作用力成正比，跟物体的质量成反比..."
},
{
"type": "fill_in_blank",
"content": "在三角形中，若三边长分别为 $a, b, c$，则余弦定理公式为 $c^2 = $ ______ 。",
"points": 5,
"answer": "a^2 + b^2 - 2ab \\cos C"
}
]
}输出结果
工具将返回一个 JSON，包含生成的 DOCX 文件的下载链接：
{
"content": [
{
"type": "text",
"text": "Successfully generated exam paper: \"高中物理与数学联合测试\"\n\nDownload Link: https://tmp.link/f/...\nFile Size: 12345 bytes\n\n(Note: This link is valid for 7 days)"
}
]
}