用途
slite-mcp 是一个 Model Context Protocol（MCP）服务器，用于与 Slite 的 API 集成，让用户能够搜索、检索、创建和编辑 Slite 工作区中的笔记。该项目现已标记为 DEPRECATED（弃用），不再维护，官方建议迁移至 Slite 官方 MCP 服务器。
主要能力
该 MCP 服务器提供以下工具：
- 搜索笔记（slite_search_notes）：在 Slite 工作区中搜索笔记，支持查询字符串和每页结果数参数。
- 获取笔记内容（slite_get_note）：通过笔记 ID 检索特定笔记，支持 markdown 或 HTML 格式。
- 浏览层级（slite_get_note_children）：获取任意父笔记的子笔记，支持分页游标。
- 提问（slite_ask）：基于工作区内容进行自然语言问答，可限定在某个父笔记下搜索。
- 创建笔记（slite_create_note）：使用 markdown 内容创建新笔记，可指定父笔记 ID。
- 编辑笔记（slite_edit_note）：通过搜索替换进行定向编辑，支持 dry-run 验证，比全文重写更快更安全。
- 更新笔记（slite_update_note）：替换整个笔记内容，适用于大规模重写。
使用方式
- 获取 Slite API Key：登录 Slite 工作区，进入 Settings → API，生成新的 API key。
- 配置 MCP 服务器：将服务器添加到 MCP 配置文件（~/.mcp.json）中。
- 配置完成后即可使用上述工具。
项目还提供测试命令 test:setup，用于在 Slite 工作区创建测试文档（一个包含 55 个子笔记的父笔记，以及一个带有可搜索关键词的子笔记），该脚本具有幂等性，不会重复创建。测试套件涵盖 API 测试、错误处理、分页、内容格式、MCP 服务器集成和写操作。
适用场景
适用于需要将 Slite 知识库与支持 MCP 的 AI 工具或客户端集成的团队，实现笔记的搜索、检索、创建和编辑自动化。
限制与注意事项
- 该项目已弃用，不再维护。官方 MCP 服务器在以下方面有所改进：Mermaid/图表块正常工作、通过 modify-block 进行块级编辑（无需全文重写）、支持 callouts、表格、可折叠块等所有原生 Slite 块，并由 Slite 直接维护。
- 迁移方式：更新 MCP 配置以使用官方 MCP。
- 需要 TypeScript 5.0+ 和有效的 Slite API key。
- 若遇到错误，可能是 Slite API 已变更，需检查测试脚本中的响应格式和必需参数。
- 项目采用 MIT 许可证。
