mcp-documentation-server

本地优先的文档管理与语义搜索服务器,内置Web仪表盘。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:mcp-documentation-server。
它的用途是:本地优先的文档管理与语义搜索服务器,内置Web仪表盘。
完整的 Skill 内容见:https://321skill.com/skills/mcp-documentation-server/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我在我的本地知识库里搜索一下‘Orama向量数据库’的相关内容。”,它会通过调用该服务器的REST API,在你的所有文档中进行混合搜索,并返回最相关的文本片段及其来源文档。或者,你可以说:“把这篇新写的API说明文档添加到我的知识库里。”,AI会通过add_document工具或对应的API端点,将内容存储到本地向量数据库中。

介绍

MCP Documentation Server 解决了AI编程助手(如Claude Code、Cursor)在本地开发环境中难以高效检索和管理个人或项目文档的问题。它提供了一个完全离线的知识库,支持对.txt、.md、.pdf文件进行全文和向量语义混合搜索,无需依赖外部数据库或云API。

使用方式非常灵活:你可以通过标准的MCP协议将其集成到AI助手,通过其自动启动的Web界面(端口3080)进行可视化管理,或者,更推荐的方式是,通过其暴露的REST API直接与AI助手交互。后者避免了将冗长的工具模式加载到对话上下文中,能显著优化Token消耗。

它非常适合需要频繁查阅技术文档、管理私有知识库或进行代码上下文研究的开发者、技术写作者和研究者。无论是整理零散知识、撰写技术文档,还是开发需要深度文档检索能力的AI应用,它都能提供支持。

建议优先使用其REST API模式与AI助手配合,这能获得最流畅的体验。首次使用前,确保本地环境已安装Node.js。如果需要进行高级的文档分析,可以配置可选的Google Gemini API密钥。

核心特点

与多数仅提供CLI接口的MCP服务器不同,它内置了功能完整的Web仪表盘,支持拖拽上传和可视化文档管理;同时,它将所有MCP工具都暴露为REST API,为AI代理提供了更精简、无模式的交互接口。

注意事项

不适合需要实时同步或多人协作编辑的在线文档管理场景。

常见问题

如何从AI助手(如Claude Desktop)中搜索我的本地文档?

配置好MCP服务器后,AI助手即可直接调用search_all_documents等工具。更推荐的方式是让AI助手调用其REST API接口(http://127.0.0.1:3080/api/search-all),这样更节省Token。

支持哪些文件格式?

目前支持.txt、.md和.pdf格式的文件,可通过Web界面拖拽上传或通过API添加。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/mcp-documentation-server/raw/index.md 读取 mcp-documentation-server 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。