Metadata-Version: 2.4
Name: confluence-rovo-mcp
Version: 1.0.0
Summary: Atlassian Rovo MCP Server for Confluence — direct REST API integration with image support
Author: 团子
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.0.0
Requires-Dist: httpx>=0.27.0

# Confluence Rovo MCP Server

Confluence REST API MCP Server — 直连 Confluence Cloud 或 Server/Data Center。

## 安装

```bash
cd D:\code\ai\confluence-rovo-mcp
pip install -e . --no-deps
```

## 配置（Hermes config.yaml）

### Server/Data Center 模式（公司 Confluence）

```yaml
mcp_servers:
  confluence-rovo:
    command: python
    args: ["-m", "confluence_rovo_mcp.server"]
    env:
      CONFLUENCE_BASE_URL: "https://pmo.mcd.com.cn/confluence"
      CONFLUENCE_TOKEN: "你的PAT令牌"
      CONFLUENCE_AUTH_METHOD: "bearer"
      CONFLUENCE_VERIFY_SSL: "false"
    timeout: 60
    autoApprove:
      - confluence_validate_connection
      - confluence_search
      - confluence_get_page
      - confluence_list_spaces
      - confluence_list_attachments
      - confluence_list_images
      - confluence_get_image
      - confluence_download_attachment
```

### Atlassian Cloud 模式

```yaml
    env:
      CONFLUENCE_DOMAIN: "myteam"           # myteam.atlassian.net 的前缀
      CONFLUENCE_EMAIL: "you@company.com"
      CONFLUENCE_TOKEN: "api-token"          # https://id.atlassian.com 获取
```

## 环境变量

| 变量 | 必填 | 说明 |
|------|------|------|
| CONFLUENCE_TOKEN | ✅ | PAT 令牌 |
| CONFLUENCE_BASE_URL | Server/DC | 如 `https://pmo.mcd.com.cn/confluence` |
| CONFLUENCE_DOMAIN | Cloud | 如 `myteam`（myteam.atlassian.net） |
| CONFLUENCE_EMAIL | Cloud | 账号邮箱 |
| CONFLUENCE_AUTH_METHOD | 可选 | `auto`/`basic`/`bearer`，默认 auto |
| CONFLUENCE_VERIFY_SSL | 可选 | `true`/`false`，内网建议 false |

## 工具列表（13个）

| 工具 | 功能 |
|------|------|
| `confluence_validate_connection` | 验证连接 |
| `confluence_search` | CQL 搜索 |
| `confluence_get_page` | 读取页面 |
| `confluence_create_page` | 创建页面 |
| `confluence_update_page` | 更新页面 |
| `confluence_delete_page` | 删除页面 |
| `confluence_list_spaces` | 列出空间 |
| `confluence_list_attachments` | 列出附件 |
| `confluence_list_images` | 列出图片 |
| `confluence_get_image` | 查看图片（base64 data URL） |
| `confluence_upload_image` | 上传图片 |
| `confluence_upload_attachment` | 上传文件 |
| `confluence_download_attachment` | 下载附件到本地 |

## 获取 PAT 令牌

Confluence Server/DC：`https://你的域名/confluence/plugins/personalaccesstokens/usertokens.action`

启用后执行 `/reload-mcp` 即可使用。
