Docmost의 Model Context Protocol (MCP) 서버는 AI 에이전트가 검색, 생성, 수정 및 문서 페이지와 공백을 구성합니다.

특징

핵심 관리

-create_page: 스마트 생성 도구. 콘텐츠 만들기 (출입을 통해) 및 손잡이 hierarchy (부모 아래 정렬) 한 이동. -update_page: 페이지 내용 및/또는 제목을 업데이트합니다. 업데이트는 실시간 협업(WebSocket)을 통해 수행됩니다. -delete_page / delete_pages]: 한 번에 단일 또는 여러 페이지를 삭제합니다.

• move_page: 새 부모 또는 뿌리로 이동하여 계층화된 페이지를 구성합니다.

탐험 & 검색

• search: 선택 공간 필터링 ([query], spaceId])를 가진 공간의 전체 텍스트 검색. -get_workspace: 현재 Docmost workspace에 대한 정보를 얻으십시오. -list_spaces: 현재 작업 공간 내에서 모든 공간을 볼 수 있습니다. -list_groups: 현재 workspace 내의 모든 그룹 보기. -list_pages: 공간 내의 페이지 목록 (주문 updatedAt 후손).
• get_page: 특정 페이지의 전체 내용과 메타데이터를 검색합니다.

기술적인 세부사항

Docmost MCP Server

A Model Context Protocol (MCP) server for Docmost, enabling AI agents to search, create, modify, and organize documentation pages and spaces.

Features

Core Management

• create_page: Smart creation tool. Creates content (via import) AND handles hierarchy (nesting under a parent) in one go.
• update_page: Update a page’s content and/or title. Updates are performed via real-time collaboration (WebSocket).
• delete_page / delete_pages: Delete single or multiple pages at once.
• move_page: Organize pages hierarchically by moving them to a new parent or root.

Exploration & Retrieval

• search: Full-text search across spaces with optional space filtering (query, spaceId).
• get_workspace: Get information about the current Docmost workspace.
• list_spaces: View all spaces within the current workspace.
• list_groups: View all groups within the current workspace.
• list_pages: List pages within a space (ordered by updatedAt descending).
• get_page: Retrieve full content and metadata of a specific page.

Technical Details

• Automatic Markdown Conversion: Page content is automatically converted from Docmost’s internal ProseMirror/TipTap JSON format to clean Markdown for easy agent consumption. Supports all Docmost extensions including callouts, task lists, math blocks, embeds, and more.
• Smart Import API: Uses Docmost’s import API to ensure clean Markdown-to-ProseMirror conversion when creating pages.
• Child Preservation: The update_page tool creates a new page ID but effectively simulates an in-place update by reparenting existing child pages to the new version.
• Pagination Support: Automatically handles pagination for large datasets (spaces, pages, groups).
• Filtered Responses: API responses are filtered to include only relevant information, optimizing data transfer for agents.

Installation

npm install
npm run build

Configuration

This server requires the following environment variables to be set:

• DOCMOST_API_URL: The full URL to your Docmost API (e.g., https://docs.example.com/api).
• DOCMOST_EMAIL: The email address for authentication.
• DOCMOST_PASSWORD: The password for authentication.

usage with Claude Desktop / generic MCP Client

Add the following to your MCP configuration (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "docmost-local": {
      "command": "node",
      "args": ["./build/index.js"],
      "env": {
        "DOCMOST_API_URL": "http://localhost:3000/api",
        "DOCMOST_EMAIL": "[email protected]",
        "DOCMOST_PASSWORD": "test"
      }
    }
  }
}

Development

# Watch mode
npm run watch

# Build
npm run build

License

MIT