epub-mcp-server

# 📋模板搜索 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 ``` ### 🎮 第三步：…