epub-mcp-server 0.1.1

智能模板发现助手 - 为 AI 应用提供强大的 epub360 模板搜索能力

📋模板搜索 MCP 服务

智能模板发现助手 - 为 AI 应用提供强大的 epub360 模板搜索能力

🎯 产品定位

智能模板发现助手 - 一个专为 AI 应用设计的 epub360 模板搜索服务，通过 Model Context Protocol (MCP) 标准为 Cursor、Claude 等 AI 工具提供强大的模板检索能力。

🌟 核心价值

• 🤖 AI 原生设计 - 专为 AI 工具优化的接口和响应格式
• 🔗 标准化集成 - 遵循 MCP 协议，可无缝集成到任何支持 MCP 的 AI 应用
• 🧠 智能搜索 - 支持中文关键词搜索，精准匹配模板需求
• ⚡ 高性能 - 快速响应，10秒超时保护

✨ 功能特性

| 特性 | 说明 |

|------|------|

| 🔍 中文搜索 | 支持中文关键词智能搜索 |

| 📊 灵活限制 | 可配置返回数量（1-50个） |

| 🎨 详细信息 | 返回模板名称、描述、封面等 |

| ⚡ 快速响应 | 10秒超时保护，确保响应速度 |

| 🛡️ 错误处理 | 完善的异常处理和错误提示 |

📝 完善的日志系统

• 🛡️ 完善的异常处理机制
• 📝 详细的请求/响应日志
• 🔄 网络超时和重试保护
• 📊 实时状态监控

🎯 适用场景

1. 🤖 AI 辅助设计场景

用户: "帮我找一些科技风格的模板"

AI: 通过 MCP 调用模板搜索，返回相关模板列表

典型对话：

• "我需要制作一个商务演示，有什么模板推荐？"
• "找一些适合教育培训的模板"
• "搜索几个现代简约风格的设计模板"

2. 📝 内容创作工作流

| 场景 | 描述 | 示例 |

|------|------|------|

| 博客写作 | 搜索适合的文章模板 | 技术博客、生活分享模板 |

| 演示制作 | 快速找到演示文稿模板 | 产品发布、项目汇报模板 |

| 营销材料 | 寻找宣传册、海报模板 | 品牌宣传、活动推广模板 |

3. 🛠️ 开发集成场景

• Cursor IDE - 在编程时快速查找UI模板
• 设计工具 - 集成到设计软件中
• 自动化工具 - 批量模板分析和管理
• 工作流集成 - 与现有设计流程无缝对接

4. 🎓 教育培训场景

• 课程设计 - 查找教育相关模板
• 培训材料 - 搜索培训演示模板
• 学术展示 - 寻找学术报告模板

📚 使用教程

🚀 第一步：启动服务器

# 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：

{

  "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 后，你可以通过以下方式使用：

🔍 基础搜索示例

# 简单搜索

请帮我搜索一些商务风格的模板

# 指定数量

找5个教育相关的模板给我

# 特定主题

我需要科技、未来感的设计模板

# 具体用途

帮我找适合产品发布会的演示模板

🛠️ 直接工具调用

# 直接调用工具

使用 search_templates 工具搜索 "医疗" 相关的模板，限制10个结果

# 批量分析

帮我分析一下 "商务"、"教育"、"科技" 这三个主题的模板特点

# 对比搜索

对比一下 "简约" 和 "复古" 风格的模板有什么区别

---

🎨 让 AI 驱动的设计工作流更加高效！ ✨

这个 MCP 服务器为创意工作者提供了强大的模板搜索能力，让设计灵感触手可及！