{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_vaksdavdpw42","handle":"epub-mcp-server","url":"https://wellknown.network/agents/epub-mcp-server","links":{"self":"https://wellknown.network/agents/epub-mcp-server/record.json","html":"https://wellknown.network/agents/epub-mcp-server","markdown":"https://wellknown.network/agents/epub-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/epub-mcp-server","status":"https://wellknown.network/api/v1/agents/epub-mcp-server/status","claim":"https://wellknown.network/agents/epub-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/epub-mcp-server/claim.json","badge":"https://wellknown.network/agents/epub-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/epub-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/epub-mcp-server/tools"},"ard":{"identifier":"urn:air::server:epub-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"epub-mcp-server","summary":"智能模板发现助手 - 为 AI 应用提供强大的 epub360 模板搜索能力","description":"# 📋模板搜索 MCP 服务\n\n> 智能模板发现助手 - 为 AI 应用提供强大的 epub360 模板搜索能力\n\n## 🎯 产品定位\n\n**智能模板发现助手** - 一个专为 AI 应用设计的 epub360 模板搜索服务，通过 Model Context Protocol (MCP) 标准为 Cursor、Claude 等 AI 工具提供强大的模板检索能力。\n\n### 🌟 核心价值\n\n- **🤖 AI 原生设计** - 专为 AI 工具优化的接口和响应格式\n- **🔗 标准化集成** - 遵循 MCP 协议，可无缝集成到任何支持 MCP 的 AI 应用\n- **🧠 智能搜索** - 支持中文关键词搜索，精准匹配模板需求\n- **⚡ 高性能** - 快速响应，10秒超时保护\n\n#### ✨ 功能特性\n\n| 特性 | 说明 |\n\n|------|------|\n\n| 🔍 中文搜索 | 支持中文关键词智能搜索 |\n\n| 📊 灵活限制 | 可配置返回数量（1-50个） |\n\n| 🎨 详细信息 | 返回模板名称、描述、封面等 |\n\n| ⚡ 快速响应 | 10秒超时保护，确保响应速度 |\n\n| 🛡️ 错误处理 | 完善的异常处理和错误提示 |\n\n### 📝 完善的日志系统\n\n- 🛡️ 完善的异常处理机制\n- 📝 详细的请求/响应日志\n- 🔄 网络超时和重试保护\n- 📊 实时状态监控\n\n## 🎯 适用场景\n\n### 1. 🤖 AI 辅助设计场景\n\n```markdown\n用户: \"帮我找一些科技风格的模板\"\n\nAI: 通过 MCP 调用模板搜索，返回相关模板列表\n\n```\n\n**典型对话：**\n\n- \"我需要制作一个商务演示，有什么模板推荐？\"\n- \"找一些适合教育培训的模板\"\n- \"搜索几个现代简约风格的设计模板\"\n\n### 2. 📝 内容创作工作流\n\n| 场景 | 描述 | 示例 |\n\n|------|------|------|\n\n| **博客写作** | 搜索适合的文章模板 | 技术博客、生活分享模板 |\n\n| **演示制作** | 快速找到演示文稿模板 | 产品发布、项目汇报模板 |\n\n| **营销材料** | 寻找宣传册、海报模板 | 品牌宣传、活动推广模板 |\n\n### 3. 🛠️ 开发集成场景\n\n- **Cursor IDE** - 在编程时快速查找UI模板\n- **设计工具** - 集成到设计软件中\n- **自动化工具** - 批量模板分析和管理\n- **工作流集成** - 与现有设计流程无缝对接\n\n### 4. 🎓 教育培训场景\n\n- **课程设计** - 查找教育相关模板\n- **培训材料** - 搜索培训演示模板\n- **学术展示** - 寻找学术报告模板\n\n## 📚 使用教程\n\n### 🚀 第一步：启动服务器\n\n```bash\n# 1. 克隆项目，进入项目目录\n\ngit clone https://github.com/21epub/epub-mcp-server.git && cd epub-mcp-server\n\n# 2. 确保Python环境\n\npython --version  # 需要 Python 3.8+\n\n# 3. 安装依赖\n\npip install mcp requests\n\n# 4. 启动 MCP 服务器\n\npython src/template_mcp_http_server.py\n\n```\n\n### ⚙️ 第二步：配置 Cursor\n\n#### 方法一：编辑配置文件（推荐）\n\n编辑 `~/.cursor/mcp.json`：\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#### 方法二：通过设置界面 \n\n1. **打开 Cursor 设置**\n\n   - macOS: `Cmd + Shift + J`\n   - Windows/Linux: `Ctrl + Shift + J`\n\n2. **添加 MCP 服务器**\n\n   - 找到 \"MCP Servers\" 选项卡\n   - 点击添加新服务器\n\n3. **配置服务器信息**\n\n   ```\n   名称: epub_template_search\n   \n   URL: http://localhost:8081/api/template\n   \n   传输方式: SSE\n   \n   ```\n\n### 🎮 第三步：…","publisher":null,"homepage":"https://github.com/21epub/epub-mcp-server","repository":"https://github.com/21epub/epub-mcp-server/issues","version":"0.1.1","license":"MIT","protocols":["mcp"],"tags":["mcp","epub360","template","search","ai","assistant"],"pricing":null,"endpoints":[{"url":"pypi:epub-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"ai.prompting","name":"Prompt Management","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["ai","dev"],"language":"zh"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"epub-mcp-server","registry":"pypi","observedAt":"2026-09-15T14:26:53.238Z","publishedAt":"2025-07-30T08:45:26.188033Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"epub-mcp-server","url":"https://pypi.org/project/epub-mcp-server/","firstSeenAt":"2026-09-09T15:21:39.722Z","fetchedAt":"2026-09-15T14:24:46.912Z","normalizedAt":"2026-09-15T14:24:46.912Z"}]},"firstSeenAt":"2026-09-09T15:21:39.722Z","updatedAt":"2026-09-15T14:26:53.238Z"}