feat: implement initial Docmost Model Context Protocol (MCP) server for documentation management.

README.md

@@ -0,0 +1,83 @@
+# Docmost MCP Server
+
+A Model Context Protocol (MCP) server for [Docmost](https://docmost.com/), 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`**: ⚠️ **IMPORTANT**: This tool **recreates the page** with a **new ID** and **deletes the old page**. While it preserves child pages and hierarchy, **all references to the old page ID will break**, including:
+  - Comments and discussions
+  - Page history/changelog
+
+  This is a workaround limitation due to Docmost's API not providing a native update endpoint. Use with caution!
+
+- **`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
+
+```bash
+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`):
+
+```json
+{
+  "mcpServers": {
+    "docmost": {
+      "command": "node",
+      "args": ["/path/to/docmost-mcp/build/index.js"],
+      "env": {
+        "DOCMOST_API_URL": "https://your-docmost-instance.com/api",
+        "DOCMOST_EMAIL": "your-email@example.com",
+        "DOCMOST_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+## Development
+
+```bash
+# Watch mode
+npm run watch
+
+# Build
+npm run build
+```
+
+## License
+
+MIT