# 📋模板搜索 MCP 服务
> 智能模板发现助手 - 为 AI 应用提供强大的 epub360 模板搜索能力
## 🎯 产品定位
**智能模板发现助手** - 一个专为 AI 应用设计的 epub360 模板搜索服务，通过 Model Context Protocol (MCP) 标准为 Cursor、Claude 等 AI 工具提供强大的模板检索能力。
### 🌟 核心价值
- **🤖 AI 原生设计** - 专为 AI 工具优化的接口和响应格式
- **🔗 标准化集成** - 遵循 MCP 协议，可无缝集成到任何支持 MCP 的 AI 应用
- **🧠 智能搜索** - 支持中文关键词搜索，精准匹配模板需求
- **⚡ 高性能** - 快速响应，10秒超时保护
#### ✨ 功能特性
| 特性 | 说明 |
|------|------|
| 🔍 中文搜索 | 支持中文关键词智能搜索 |
| 📊 灵活限制 | 可配置返回数量（1-50个） |
| 🎨 详细信息 | 返回模板名称、描述、封面等 |
| ⚡ 快速响应 | 10秒超时保护，确保响应速度 |
| 🛡️ 错误处理 | 完善的异常处理和错误提示 |
### 📝 完善的日志系统
- 🛡️ 完善的异常处理机制
- 📝 详细的请求/响应日志
- 🔄 网络超时和重试保护
- 📊 实时状态监控
## 🎯 适用场景
### 1. 🤖 AI 辅助设计场景
```markdown
用户: "帮我找一些科技风格的模板"
AI: 通过 MCP 调用模板搜索，返回相关模板列表
```
**典型对话：**
- "我需要制作一个商务演示，有什么模板推荐？"
- "找一些适合教育培训的模板"
- "搜索几个现代简约风格的设计模板"
### 2. 📝 内容创作工作流
| 场景 | 描述 | 示例 |
|------|------|------|
| **博客写作** | 搜索适合的文章模板 | 技术博客、生活分享模板 |
| **演示制作** | 快速找到演示文稿模板 | 产品发布、项目汇报模板 |
| **营销材料** | 寻找宣传册、海报模板 | 品牌宣传、活动推广模板 |
### 3. 🛠️ 开发集成场景
- **Cursor IDE** - 在编程时快速查找UI模板
- **设计工具** - 集成到设计软件中
- **自动化工具** - 批量模板分析和管理
- **工作流集成** - 与现有设计流程无缝对接
### 4. 🎓 教育培训场景
- **课程设计** - 查找教育相关模板
- **培训材料** - 搜索培训演示模板
- **学术展示** - 寻找学术报告模板
## 📚 使用教程
### 🚀 第一步：启动服务器
```bash
# 1. 克隆项目，进入项目目录
git clone https://github.com/21epub/epub-mcp-server.git && cd epub-mcp-server
# 2. 确保Python环境
python --version # 需要 Python 3.8+
# 3. 安装依赖
pip install mcp requests
# 4. 启动 MCP 服务器
python src/template_mcp_http_server.py
```
### ⚙️ 第二步：配置 Cursor
#### 方法一：编辑配置文件（推荐）
编辑 `~/.cursor/mcp.json`：
```json
{
"mcpServers": {
"epub_template_search": {
"url": "http://localhost:8081/api/template",
"transport": "sse"
}
}
}
```
#### 方法二：通过设置界面
1. **打开 Cursor 设置**
- macOS: `Cmd + Shift + J`
- Windows/Linux: `Ctrl + Shift + J`
2. **添加 MCP 服务器**
- 找到 "MCP Servers" 选项卡
- 点击添加新服务器
3. **配置服务器信息**
```
名称: epub_template_search
URL: http://localhost:8081/api/template
传输方式: SSE
```
### 🎮 第三步：在 Cursor 中使用
重启 Cursor 后，你可以通过以下方式使用：
#### 🔍 基础搜索示例
```markdown
# 简单搜索
请帮我搜索一些商务风格的模板
# 指定数量
找5个教育相关的模板给我
# 特定主题
我需要科技、未来感的设计模板
# 具体用途
帮我找适合产品发布会的演示模板
```
#### 🛠️ 直接工具调用
```markdown
# 直接调用工具
使用 search_templates 工具搜索 "医疗" 相关的模板，限制10个结果
# 批量分析
帮我分析一下 "商务"、"教育"、"科技" 这三个主题的模板特点
# 对比搜索
对比一下 "简约" 和 "复古" 风格的模板有什么区别
```
------
**🎨 让 AI 驱动的设计工作流更加高效！** ✨
> 这个 MCP 服务器为创意工作者提供了强大的模板搜索能力，让设计灵感触手可及！
Raw data
{
"_id": null,
"home_page": null,
"name": "epub-mcp-server",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "mcp, epub360, template, search, ai, assistant",
"author": null,
"author_email": "zhulinyi <536555895@qq.com>",
"download_url": "https://files.pythonhosted.org/packages/93/68/326e7f462ee39aa89ce8dffc8fbc7df66e865b4af1d80a61eafec8be92ec/epub_mcp_server-0.1.1.tar.gz",
"platform": null,
"description": "# \ud83d\udccb\u6a21\u677f\u641c\u7d22 MCP \u670d\u52a1\n\n> \u667a\u80fd\u6a21\u677f\u53d1\u73b0\u52a9\u624b - \u4e3a AI \u5e94\u7528\u63d0\u4f9b\u5f3a\u5927\u7684 epub360 \u6a21\u677f\u641c\u7d22\u80fd\u529b\n\n## \ud83c\udfaf \u4ea7\u54c1\u5b9a\u4f4d\n\n**\u667a\u80fd\u6a21\u677f\u53d1\u73b0\u52a9\u624b** - \u4e00\u4e2a\u4e13\u4e3a AI \u5e94\u7528\u8bbe\u8ba1\u7684 epub360 \u6a21\u677f\u641c\u7d22\u670d\u52a1\uff0c\u901a\u8fc7 Model Context Protocol (MCP) \u6807\u51c6\u4e3a Cursor\u3001Claude \u7b49 AI \u5de5\u5177\u63d0\u4f9b\u5f3a\u5927\u7684\u6a21\u677f\u68c0\u7d22\u80fd\u529b\u3002\n\n### \ud83c\udf1f \u6838\u5fc3\u4ef7\u503c\n\n- **\ud83e\udd16 AI \u539f\u751f\u8bbe\u8ba1** - \u4e13\u4e3a AI \u5de5\u5177\u4f18\u5316\u7684\u63a5\u53e3\u548c\u54cd\u5e94\u683c\u5f0f\n- **\ud83d\udd17 \u6807\u51c6\u5316\u96c6\u6210** - \u9075\u5faa MCP \u534f\u8bae\uff0c\u53ef\u65e0\u7f1d\u96c6\u6210\u5230\u4efb\u4f55\u652f\u6301 MCP \u7684 AI \u5e94\u7528\n- **\ud83e\udde0 \u667a\u80fd\u641c\u7d22** - \u652f\u6301\u4e2d\u6587\u5173\u952e\u8bcd\u641c\u7d22\uff0c\u7cbe\u51c6\u5339\u914d\u6a21\u677f\u9700\u6c42\n- **\u26a1 \u9ad8\u6027\u80fd** - \u5feb\u901f\u54cd\u5e94\uff0c10\u79d2\u8d85\u65f6\u4fdd\u62a4\n\n\n\n#### \u2728 \u529f\u80fd\u7279\u6027\n\n| \u7279\u6027 | \u8bf4\u660e |\n\n|------|------|\n\n| \ud83d\udd0d \u4e2d\u6587\u641c\u7d22 | \u652f\u6301\u4e2d\u6587\u5173\u952e\u8bcd\u667a\u80fd\u641c\u7d22 |\n\n| \ud83d\udcca \u7075\u6d3b\u9650\u5236 | \u53ef\u914d\u7f6e\u8fd4\u56de\u6570\u91cf\uff081-50\u4e2a\uff09 |\n\n| \ud83c\udfa8 \u8be6\u7ec6\u4fe1\u606f | \u8fd4\u56de\u6a21\u677f\u540d\u79f0\u3001\u63cf\u8ff0\u3001\u5c01\u9762\u7b49 |\n\n| \u26a1 \u5feb\u901f\u54cd\u5e94 | 10\u79d2\u8d85\u65f6\u4fdd\u62a4\uff0c\u786e\u4fdd\u54cd\u5e94\u901f\u5ea6 |\n\n| \ud83d\udee1\ufe0f \u9519\u8bef\u5904\u7406 | \u5b8c\u5584\u7684\u5f02\u5e38\u5904\u7406\u548c\u9519\u8bef\u63d0\u793a |\n\n\n\n### \ud83d\udcdd \u5b8c\u5584\u7684\u65e5\u5fd7\u7cfb\u7edf\n\n- \ud83d\udee1\ufe0f \u5b8c\u5584\u7684\u5f02\u5e38\u5904\u7406\u673a\u5236\n- \ud83d\udcdd \u8be6\u7ec6\u7684\u8bf7\u6c42/\u54cd\u5e94\u65e5\u5fd7\n- \ud83d\udd04 \u7f51\u7edc\u8d85\u65f6\u548c\u91cd\u8bd5\u4fdd\u62a4\n- \ud83d\udcca \u5b9e\u65f6\u72b6\u6001\u76d1\u63a7\n\n## \ud83c\udfaf \u9002\u7528\u573a\u666f\n\n### 1. \ud83e\udd16 AI \u8f85\u52a9\u8bbe\u8ba1\u573a\u666f\n\n```markdown\n\u7528\u6237: \"\u5e2e\u6211\u627e\u4e00\u4e9b\u79d1\u6280\u98ce\u683c\u7684\u6a21\u677f\"\n\nAI: \u901a\u8fc7 MCP \u8c03\u7528\u6a21\u677f\u641c\u7d22\uff0c\u8fd4\u56de\u76f8\u5173\u6a21\u677f\u5217\u8868\n\n```\n\n**\u5178\u578b\u5bf9\u8bdd\uff1a**\n\n- \"\u6211\u9700\u8981\u5236\u4f5c\u4e00\u4e2a\u5546\u52a1\u6f14\u793a\uff0c\u6709\u4ec0\u4e48\u6a21\u677f\u63a8\u8350\uff1f\"\n- \"\u627e\u4e00\u4e9b\u9002\u5408\u6559\u80b2\u57f9\u8bad\u7684\u6a21\u677f\"\n- \"\u641c\u7d22\u51e0\u4e2a\u73b0\u4ee3\u7b80\u7ea6\u98ce\u683c\u7684\u8bbe\u8ba1\u6a21\u677f\"\n\n### 2. \ud83d\udcdd \u5185\u5bb9\u521b\u4f5c\u5de5\u4f5c\u6d41\n\n| \u573a\u666f | \u63cf\u8ff0 | \u793a\u4f8b |\n\n|------|------|------|\n\n| **\u535a\u5ba2\u5199\u4f5c** | \u641c\u7d22\u9002\u5408\u7684\u6587\u7ae0\u6a21\u677f | \u6280\u672f\u535a\u5ba2\u3001\u751f\u6d3b\u5206\u4eab\u6a21\u677f |\n\n| **\u6f14\u793a\u5236\u4f5c** | \u5feb\u901f\u627e\u5230\u6f14\u793a\u6587\u7a3f\u6a21\u677f | \u4ea7\u54c1\u53d1\u5e03\u3001\u9879\u76ee\u6c47\u62a5\u6a21\u677f |\n\n| **\u8425\u9500\u6750\u6599** | \u5bfb\u627e\u5ba3\u4f20\u518c\u3001\u6d77\u62a5\u6a21\u677f | \u54c1\u724c\u5ba3\u4f20\u3001\u6d3b\u52a8\u63a8\u5e7f\u6a21\u677f |\n\n### 3. \ud83d\udee0\ufe0f \u5f00\u53d1\u96c6\u6210\u573a\u666f\n\n- **Cursor IDE** - \u5728\u7f16\u7a0b\u65f6\u5feb\u901f\u67e5\u627eUI\u6a21\u677f\n- **\u8bbe\u8ba1\u5de5\u5177** - \u96c6\u6210\u5230\u8bbe\u8ba1\u8f6f\u4ef6\u4e2d\n- **\u81ea\u52a8\u5316\u5de5\u5177** - \u6279\u91cf\u6a21\u677f\u5206\u6790\u548c\u7ba1\u7406\n- **\u5de5\u4f5c\u6d41\u96c6\u6210** - \u4e0e\u73b0\u6709\u8bbe\u8ba1\u6d41\u7a0b\u65e0\u7f1d\u5bf9\u63a5\n\n### 4. \ud83c\udf93 \u6559\u80b2\u57f9\u8bad\u573a\u666f\n\n- **\u8bfe\u7a0b\u8bbe\u8ba1** - \u67e5\u627e\u6559\u80b2\u76f8\u5173\u6a21\u677f\n- **\u57f9\u8bad\u6750\u6599** - \u641c\u7d22\u57f9\u8bad\u6f14\u793a\u6a21\u677f\n- **\u5b66\u672f\u5c55\u793a** - \u5bfb\u627e\u5b66\u672f\u62a5\u544a\u6a21\u677f\n\n## \ud83d\udcda \u4f7f\u7528\u6559\u7a0b\n\n### \ud83d\ude80 \u7b2c\u4e00\u6b65\uff1a\u542f\u52a8\u670d\u52a1\u5668\n\n```bash\n# 1. \u514b\u9686\u9879\u76ee\uff0c\u8fdb\u5165\u9879\u76ee\u76ee\u5f55\n\ngit clone https://github.com/21epub/epub-mcp-server.git && cd epub-mcp-server\n\n# 2. \u786e\u4fddPython\u73af\u5883\n\npython --version # \u9700\u8981 Python 3.8+\n\n# 3. \u5b89\u88c5\u4f9d\u8d56\n\npip install mcp requests\n\n# 4. \u542f\u52a8 MCP \u670d\u52a1\u5668\n\npython src/template_mcp_http_server.py\n\n```\n\n\n\n### \u2699\ufe0f \u7b2c\u4e8c\u6b65\uff1a\u914d\u7f6e Cursor\n\n#### \u65b9\u6cd5\u4e00\uff1a\u7f16\u8f91\u914d\u7f6e\u6587\u4ef6\uff08\u63a8\u8350\uff09\n\n\u7f16\u8f91 `~/.cursor/mcp.json`\uff1a\n\n```json\n{\n\n \"mcpServers\": {\n\n \"epub_template_search\": {\n\n \"url\": \"http://localhost:8081/api/template\",\n\n \"transport\": \"sse\"\n\n }\n\n }\n\n}\n\n```\n\n#### \u65b9\u6cd5\u4e8c\uff1a\u901a\u8fc7\u8bbe\u7f6e\u754c\u9762 \n\n1. **\u6253\u5f00 Cursor \u8bbe\u7f6e**\n\n - macOS: `Cmd + Shift + J`\n - Windows/Linux: `Ctrl + Shift + J`\n\n2. **\u6dfb\u52a0 MCP \u670d\u52a1\u5668**\n\n - \u627e\u5230 \"MCP Servers\" \u9009\u9879\u5361\n - \u70b9\u51fb\u6dfb\u52a0\u65b0\u670d\u52a1\u5668\n\n3. **\u914d\u7f6e\u670d\u52a1\u5668\u4fe1\u606f**\n\n ```\n \u540d\u79f0: epub_template_search\n \n URL: http://localhost:8081/api/template\n \n \u4f20\u8f93\u65b9\u5f0f: SSE\n \n ```\n\n\n\n### \ud83c\udfae \u7b2c\u4e09\u6b65\uff1a\u5728 Cursor \u4e2d\u4f7f\u7528\n\n\u91cd\u542f Cursor \u540e\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u65b9\u5f0f\u4f7f\u7528\uff1a\n\n#### \ud83d\udd0d \u57fa\u7840\u641c\u7d22\u793a\u4f8b\n\n```markdown\n# \u7b80\u5355\u641c\u7d22\n\n\u8bf7\u5e2e\u6211\u641c\u7d22\u4e00\u4e9b\u5546\u52a1\u98ce\u683c\u7684\u6a21\u677f\n\n# \u6307\u5b9a\u6570\u91cf\n\n\u627e5\u4e2a\u6559\u80b2\u76f8\u5173\u7684\u6a21\u677f\u7ed9\u6211\n\n# \u7279\u5b9a\u4e3b\u9898\n\n\u6211\u9700\u8981\u79d1\u6280\u3001\u672a\u6765\u611f\u7684\u8bbe\u8ba1\u6a21\u677f\n\n# \u5177\u4f53\u7528\u9014\n\n\u5e2e\u6211\u627e\u9002\u5408\u4ea7\u54c1\u53d1\u5e03\u4f1a\u7684\u6f14\u793a\u6a21\u677f\n\n```\n\n#### \ud83d\udee0\ufe0f \u76f4\u63a5\u5de5\u5177\u8c03\u7528\n\n```markdown\n# \u76f4\u63a5\u8c03\u7528\u5de5\u5177\n\n\u4f7f\u7528 search_templates \u5de5\u5177\u641c\u7d22 \"\u533b\u7597\" \u76f8\u5173\u7684\u6a21\u677f\uff0c\u9650\u523610\u4e2a\u7ed3\u679c\n\n# \u6279\u91cf\u5206\u6790\n\n\u5e2e\u6211\u5206\u6790\u4e00\u4e0b \"\u5546\u52a1\"\u3001\"\u6559\u80b2\"\u3001\"\u79d1\u6280\" \u8fd9\u4e09\u4e2a\u4e3b\u9898\u7684\u6a21\u677f\u7279\u70b9\n\n# \u5bf9\u6bd4\u641c\u7d22\n\n\u5bf9\u6bd4\u4e00\u4e0b \"\u7b80\u7ea6\" \u548c \"\u590d\u53e4\" \u98ce\u683c\u7684\u6a21\u677f\u6709\u4ec0\u4e48\u533a\u522b\n\n```\n\n------\n\n**\ud83c\udfa8 \u8ba9 AI \u9a71\u52a8\u7684\u8bbe\u8ba1\u5de5\u4f5c\u6d41\u66f4\u52a0\u9ad8\u6548\uff01** \u2728\n\n> \u8fd9\u4e2a MCP \u670d\u52a1\u5668\u4e3a\u521b\u610f\u5de5\u4f5c\u8005\u63d0\u4f9b\u4e86\u5f3a\u5927\u7684\u6a21\u677f\u641c\u7d22\u80fd\u529b\uff0c\u8ba9\u8bbe\u8ba1\u7075\u611f\u89e6\u624b\u53ef\u53ca\uff01 \n",
"bugtrack_url": null,
"license": "MIT",
"summary": "\u667a\u80fd\u6a21\u677f\u53d1\u73b0\u52a9\u624b - \u4e3a AI \u5e94\u7528\u63d0\u4f9b\u5f3a\u5927\u7684 epub360 \u6a21\u677f\u641c\u7d22\u80fd\u529b",
"version": "0.1.1",
"project_urls": {
"Bug Reports": "https://github.com/21epub/epub-mcp-server/issues",
"Homepage": "https://github.com/21epub/epub-mcp-server",
"Source": "https://github.com/21epub/epub-mcp-server"
},
"split_keywords": [
"mcp",
" epub360",
" template",
" search",
" ai",
" assistant"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "f6ee5247508876335dc357f380804f25cde41574a6b4d3de317f2f461cdd5718",
"md5": "1650825814d3158a1c79ad30f79ea6b4",
"sha256": "e5329aebf4d54eaa0b15314fc82632192aebf9792f8f517cf8a0ea31b33c92a5"
},
"downloads": -1,
"filename": "epub_mcp_server-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1650825814d3158a1c79ad30f79ea6b4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 5987,
"upload_time": "2025-07-30T08:45:25",
"upload_time_iso_8601": "2025-07-30T08:45:25.079398Z",
"url": "https://files.pythonhosted.org/packages/f6/ee/5247508876335dc357f380804f25cde41574a6b4d3de317f2f461cdd5718/epub_mcp_server-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "9368326e7f462ee39aa89ce8dffc8fbc7df66e865b4af1d80a61eafec8be92ec",
"md5": "af73ff7ee1c00ba501c4bd06cf1d9fd2",
"sha256": "3ac5ed4f1e33c361453372f4f812dcc425b262f6024245ed4ab6f19776c84352"
},
"downloads": -1,
"filename": "epub_mcp_server-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "af73ff7ee1c00ba501c4bd06cf1d9fd2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 5522,
"upload_time": "2025-07-30T08:45:26",
"upload_time_iso_8601": "2025-07-30T08:45:26.188033Z",
"url": "https://files.pythonhosted.org/packages/93/68/326e7f462ee39aa89ce8dffc8fbc7df66e865b4af1d80a61eafec8be92ec/epub_mcp_server-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-30 08:45:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "21epub",
"github_project": "epub-mcp-server",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "epub-mcp-server"
}
JSON
