文档管理服务器

Docmost MCP Server是一个基于模型上下文协议(MCP)的实现,允许基于LLM的工具与Docmost维基交互,提供空间管理、页面发现、内容与元数据管理等文档管理功能。

  • by dev-joshi-ops
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Dev789/docmost-mcp-server

使用说明

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 .

许可证

麻省理工学院