Docmost MCP服务器
实施 模型上下文协议(MCP) 它允许基于LLM的工具(如Claude、Cursor或Windsurf)与 Docmost 维基。
  
特性
服务器支持以下文档管理功能:
空间管理
- 太空探索:列出并浏览团队和项目存储文档的所有可访问空间。
- 空间详细信息:检索有关特定空间的全面信息,包括成员计数和用户权限。
页面发现
- 全局搜索:对工作区中的所有页面标题和内容执行全文搜索。
- 分层导航:以结构化侧边栏格式浏览页面,支持根级和嵌套子页面。
内容和元数据
- 阅读内容:检索整页详细信息,包括为现代网络编辑器格式化的内容。
- 导入和创建:通过导入Markdown内容无缝创建新页面或更新现有页面。
- 元数据管理:管理页面标题和图标,以保持文档的组织性和视觉清晰性。
- 页面生命周期:支持创建空白页面骨架和永久删除或丢弃不需要的内容。
与MCP客户端集成
将服务器添加到您的 mcpServers 配置:
{
"mcpServers": {
"docmost": {
"command": "docmost-mcp",
"env": {
"DOCMOST_BASE_URL": "https://your-docmost-url.com",
"DOCMOST_API_TOKEN": "your-api-token"
}
}
}
}注: 如果docmost-mcp如果不在系统PATH中,请使用可执行文件的完整路径(例如where docmost-mcp在Windows或which docmost-mcp在Linux上)。
技术细节
- 建筑:内置
FastMCP对于服务器层和httpx用于异步API通信。 - 验证:使用Pydantic进行环境变量验证,确保在配置无效的情况下启动时发生故障。
- 身份验证生命周期:自动管理Community Edition的会话持久性和Enterprise的基于令牌的身份验证。
- 错误处理:特别捕获API错误(404s、401s),并将可人工调整的摘要返回到LLM,而不是原始崩溃数据。
发展
# Clone and setup
git clone https://github.com/Dev789/docmost-mcp-server.git
cd docmost-mcp-server
python -m venv venv
source venv/bin/activate # venv\Scripts\activate on Windows
# Editable install
pip install -e .