内容
# MCP 文档服务器
模型上下文协议（MCP）服务器，用于 [Docmost](https://docmost.com/) - 一个开源的协作文档平台。
## 功能
- **页面**：获取、搜索、列出、创建、更新、删除页面
- **空间**：列出、获取、创建空间
- **评论**：列出和在页面上添加评论
- **用户**：获取当前用户，列出工作区成员
- **历史记录**：查看页面修订历史记录
- **导出**：导出页面为 markdown、HTML 或 PDF
## 安装
### 使用 uvx（推荐）
```bash
uvx mcp-docmost
```
### 使用 pip
```bash
pip install mcp-docmost
```
## 配置
### 获取身份验证令牌
1. 在浏览器中登录 Docmost
2. 打开开发者工具（F12）→ 应用程序 → Cookie
3. 复制 `authToken` Cookie 值
### 添加到 Kiro MCP 配置
添加到 `.kiro/settings/mcp.json`：
```json
{
"mcpServers": {
"docmost": {
"command": "uvx",
"args": ["mcp-docmost"],
"env": {
"DOCMOST_URL": "https://您的-docmost-实例.com",
"DOCMOST_AUTH_TOKEN": "您的身份验证令牌-此处"
}
}
}
}
```
## 可用工具
### 页面操作
| 工具 | 描述 |
|------|-------------|
| `docmost_get_page` | 通过 ID 或 slug 获取页面信息和内容 |
| `docmost_search_pages` | 通过查询文本搜索页面 |
| `docmost_list_pages` | 列出空间中的页面或在父页面下 |
| `docmost_create_page` | 创建新页面 |
| `docmost_update_page` | 更新页面标题或内容 |
| `docmost_delete_page` | 删除页面 |
### 空间操作
| 工具 | 描述 |
|------|-------------|
| `docmost_list_spaces` | 列出工作区中的所有空间 |
| `docmost_get_space` | 通过 ID 或 slug 获取空间信息 |
| `docmost_create_space` | 创建新空间 |
### 评论操作
| 工具 | 描述 |
|------|-------------|
| `docmost_list_comments` | 列出页面上的评论 |
| `docmost_add_comment` | 在页面上添加评论 |
### 用户操作
| 工具 | 描述 |
|------|-------------|
| `docmost_get_current_user` | 获取当前身份验证用户 |
| `docmost_list_members` | 列出工作区成员 |
### 历史记录和导出
| 工具 | 描述 |
|------|-------------|
| `docmost_get_page_history` | 获取页面修订历史记录 |
| `docmost_export_page` | 导出页面（markdown/html/pdf） |
## 示例用法
```
用户：搜索关于“AI 提示”的页面
助手：[调用 docmost_search_pages，查询=“AI 提示”]
用户：获取页面 yQQmTbt8it 的内容
助手：[调用 docmost_get_page，页面 ID=“yQQmTbt8it”]
用户：列出所有空间
助手：[调用 docmost_list_spaces]
```
## 开发
```bash
# 安装依赖项
cd mcp-docmost
uv sync
# 直接运行服务器
uv run python -m mcp_docmost.server
```
## 许可证
MIT
