MCP Confluence 服务

这是一个基于 MCP (Model Context Protocol) 的 Confluence API 服务实现。该服务提供了与 Confluence 进行交互的能力，支持获取空间信息、页面内容、搜索等功能。

- 功能特性
- 快速开始
- 配置说明
- 开发指南
- MCP 工具使用指南
- 工具概览
- 性能优化
- 调试指南
- 错误处理

CONFLUENCE_URL=https://your-confluence-url CONFLUENCE_ACCESS_TOKEN=your-access-token

CONFLUENCE_URL=https://your-confluence-url CONFLUENCE_USERNAME=your-username CONFLUENCE_PASSWORD=your-password

# 服务器配置 PORT=3000 NODE_ENV=development TIMEOUT=10000 REJECT_UNAUTHORIZED=true

{ "mcpServers": { "mcp-server-confluence-ts": { "command": "cmd", "args": [ "/c", "npx", "-y", "@smithery/cli@latest", "run", "@enjoyzl/mcp-server-confluence-ts", "--config", "{\"confluenceUrl\":\"your-confluence-url\",\"confluenceUsername\":\"your-username\",\"confluencePassword\":\"your-password\"}" ] } } }

- 本地服务方式 在%USERPROFILE%\.cursor\mcp.json中添加：

{ "mcpServers": { "mcp-server-confluence-ts": { "command": "cmd", "args": [ "/k", "cd", "/d", "D:\\workspace\\code\\mcp\\mcp-server-confluence-ts", "&", "node", "dist/index.js" ] } } }

- /k: 执行命令后保持命令窗口，便于查看日志
- /d: 切换到指定驱动器
- 使用&连接多个命令
- 路径使用双反斜杠\\转义
- 环境变量可以在项目的.env文件中配置
- 使用 Smithery（推荐） 在~/.cursor/mcp.json中添加：

{ "mcpServers": { "mcp-server-confluence-ts": { "command": "bash", "args": [ "-c", "npx -y @smithery/cli@latest run @enjoyzl/mcp-server-confluence-ts --config '{\"confluenceUrl\":\"your-confluence-url\",\"confluenceUsername\":\"your-username\",\"confluencePassword\":\"your-password\"}'" ] } } }

{ "mcpServers": { "mcp-server-confluence-ts": { "command": "node", "args": ["/Users/your-username/workspace/code/mcp/mcp-server-confluence-ts/dist/index.js"], "env": { "CONFLUENCE_URL": "your-confluence-url", "CONFLUENCE_USERNAME": "youraccount", "CONFLUENCE_PASSWORD": "yourpwd", } } } }

- -c: 执行命令字符串
- 使用&&连接多个命令
- 路径使用正斜杠/
- 环境变量可以在项目的.env文件中配置
- Mac 用户主目录通常在/Users/your-username/
- Linux 用户主目录通常在/home/your-username/

# 监听文件变化并自动编译 npm run dev # 监听文件变化并自动重启服务 npm run dev:start

# 仅构建项目 npm run build # 清理构建目录 npm run clean # 清理并重新构建 npm run build:clean

# 基本调试模式 npm run inspector # 开发调试模式（带详细日志） npm run inspector:dev

📁 1. 基础信息工具（最常用） 📁 2. 页面管理工具（核心功能） 📁 3. 评论管理工具（扩展功能） 📁 4. 搜索工具（专用搜索）

{ "name": "getSpace", "arguments": { "spaceKey": "DEV" } }

{ "name": "getPageByPrettyUrl", "arguments": { "spaceKey": "DEV", "title": "API 开发指南" } }

{ "name": "managePages", "arguments": { "action": "create", "spaceKey": "DEV", "title": "新页面标题", "content": "<p>页面内容</p>", "parentId": "123456789", "representation": "storage" } }

{ "name": "managePages", "arguments": { "action": "update", "pageId": "123456789", "title": "更新的标题", "content": "<p>更新的内容</p>", "version": 2, "representation": "storage" } }

{ "name": "managePages", "arguments": { "action": "delete", "pageId": "123456789" } }

{ "name": "managePages", "arguments": { "action": "get", "pageId": "123456789" } }

{ "name": "managePages", "arguments": { "action": "getContent", "pageId": "123456789", "expand": "body.storage,version,space" } }

{ "name": "manageComments", "arguments": { "action": "create", "commentType": "regular", "pageId": "123456789", "content": "这是一条普通评论", "representation": "storage" } }

{ "name": "manageComments", "arguments": { "action": "create", "commentType": "regular", "pageId": "123456789", "content": "## 代码审查意见\n\n这段代码需要优化：\n\n- 性能问题: 数据库查询未优化\n- 安全问题: 缺少输入验证\n\n建议修改：\n\njavascript\n// 使用索引查询\nconst user = await User.findById(id).lean();\n

- 页面管理:create,update,delete,get,getContent
- 评论管理:create,update,delete,reply
- storage(推荐): HTML存储格式

- wiki: Wiki标记语法

- editor2: 编辑器格式

- view: 查看格式

- markdown🆕: Markdown格式（自动转换为HTML）
✅工具数量优化: 从12个工具合并为8个（减少33%）

✅统一API设计: 通过action参数区分操作类型

✅智能参数验证: 根据操作类型自动验证必需参数

✅完整参数注释: MCP Inspector中可查看详细参数说明

✅新增删除功能: 支持删除页面操作

✅双评论类型: 统一管理普通评论和行内评论
现在支持将 Confluence 页面导出为 Markdown 文件到当前工作空间！
- 导出指定页面为 Markdown 文件

- 支持按章节拆分大文档

- 可选的 YAML frontmatter 元数据
- ✅智能内容转换: 高质量的 HTML 到 Markdown 转换

- ✅章节拆分: 根据标题级别自动拆分大文档

- ✅元数据保留: 完整的页面信息作为 YAML frontmatter

- ✅文件管理: 智能文件命名和冲突处理

- ✅性能优化: 并发控制、重试机制、内存优化

- ✅进度跟踪: 实时导出状态和错误报告

- 优先使用 Access Token 认证方式，这样更安全

- 定期轮换 Access Token

- 不要在代码中硬编码认证信息

- 确保.env文件已添加到.gitignore中

- 在生产环境中使用环境变量或安全的配置管理系统

- 如果同时配置了两种认证方式，系统会优先使用 Access Token

- Access Token 和用户名密码认证方式只能选择其中一种

- 如果同时配置了两种认证方式，系统会优先使用 Access Token

- 确保配置的 URL 是正确的 Confluence API 地址

- 在生产环境中建议使用 HTTPS

- getSpace- 获取空间信息

- getPageByPrettyUrl- 根据标题精确获取页面

- managePages⭐️ - 统一页面管理（create/update/delete/get/getContent）
- manageComments⭐️ - 统一评论管理（create/update/delete/reply，支持普通+行内评论）

- getPageComments- 获取页面所有评论

- getComment- 获取单个评论详情
- searchContent- 搜索页面内容（支持CQL语法）

- searchComments- 搜索评论内容
- 工具数量: 从12个优化为8个（减少33%）

- API统一: 合并同类功能，通过action参数区分操作

- 功能增强: 新增页面删除、完善参数注释

- 体验提升: 按使用频率排序，提高查找效率
- MCP Inspector 调试参数指南⭐️新增

- 页面管理功能使用指南

- 评论功能使用指南

- 搜索功能故障排除

- 行内评论示例

- Confluence 7.4 兼容性

- 故障排除

评论功能支持三种API实现策略，可通过环境变量COMMENT_API_STRATEGY配置：

- 使用标准 REST API

- 兼容性好，适合 Confluence 7.4+

- 稳定性高，适合生产环境
- 自动选择策略

- 优先使用 TinyMCE，失败时回退到标准 API

- 平衡功能性和兼容性
-
COMMENT_ENABLE_FALLBACK: 是否启用回退机制 (默认: true)
- true: 当首选API失败时，自动尝试备用API

- false: 只使用指定的API，失败时直接抛出错误
COMMENT_TIMEOUT: 评论请求超时时间，单位毫秒 (默认: 15000)
- 建议标准API使用 10-15 秒

- TinyMCE API 由于需要获取token等步骤，建议 15-20 秒
- 标准API在7.4版本中稳定性更好

- TinyMCE API提供更丰富的功能，但可能有兼容性问题

- 建议在生产环境使用standard策略，开发环境可根据需要选择

`shell claude mcp add --transport stdio mcp-server-confluence-ts -- npx --registry=[PRIVATE_REGISTRY] -y @[ORGANIZATION]/mcp-server-confluence-ts

Interact with Atlassian Confluence Cloud spaces, pages, and content in real-time.

An open-source Model Context Protocol (MCP) server for Atlassian Confluence that lets AI assistants like Claude and Windsurf read, create, search, and manage Confluence wiki pages. Works with Confluence Cloud, on-premise Server, and Data Center deployments — connect your AI coding agent to your team's knowledge base in seconds via npx.

Provides secure access to Atlassian Confluence content and spaces using its REST API.

An MCP server that enables AI assistants to interact with Confluence content through a standardized interface.

Atlassian Rovo MCP Server (Streamin HTTP)

Integrate with Atlassian Cloud to access Jira tickets, issues, projects, and Confluence pages.