Enables AI-driven management of Confluence Cloud instances, including creating, updating, and deleting pages, searching content, managing spaces, querying child pages and page history, and generating Confluence code macros in storage format.
Confluence Node MCP Server
🚀 一个功能完整的 Confluence MCP (Model Context Protocol) 服务器,让 AI 助手能够直接在 Cursor 中创建、更新和管理 Confluence 文档。
✨ 特性
🤖 AI 驱动:在 Cursor 中通过自然语言操作 Confluence (KMS)
📄 页面管理:创建、更新、删除、搜索 Confluence 页面
🔍 强大搜索:支持全文搜索、子页面查询、历史版本查看
🏢 Space 管理:列出和管理所有可访问的 Spaces
🔒 安全可靠:使用 API Token 认证,支持所有 Confluence Cloud 功能
🧩 宏辅助:生成 Confluence Code Macro(storage format),安全插入代码块
📦 项目结构
🚀 快速开始
1️⃣ 安装依赖
2️⃣ 配置环境变量
复制 env-example.txt 为 .env,并填入你的配置:
3️⃣ 配置 Cursor
编辑 ~/.cursor/mcp.json(参考 mcp-config-example.json):
4️⃣ 重启 Cursor
完全关闭并重新打开 Cursor。
5️⃣ 开始使用
在 Cursor 中直接对话即可:
📖 文档
🛠️ 可用工具
类别 | 工具 | 说明 |
Space |
| 列出所有可访问的 Spaces |
页面操作 |
| 创建新页面 |
| 更新现有页面 | |
| 创建或更新(智能判断) | |
| 获取页面详情 | |
| 删除页面 | |
搜索 |
| 搜索页面 |
| 获取子页面 | |
| 查看页面历史 | |
宏 |
| 生成 Confluence Code Macro(storage format) |
💡 使用示例
创建页面
搜索页面
更新页面
查看 Spaces
🔧 开发和测试
测试 MCP Server
使用 MCP Inspector 调试
查看 Cursor MCP 日志
macOS:
~/Library/Logs/Cursor/Windows:
%APPDATA%\Cursor\logs\
🐛 故障排查
MCP Server 无法启动
检查
.env配置是否正确验证 API Token 是否有效
确认 Confluence URL 可访问
运行
npm run mcp查看错误信息
在 Cursor 中看不到 MCP 工具
检查
~/.cursor/mcp.json路径是否正确(必须是绝对路径)重启 Cursor(完全退出)
查看 Cursor 日志文件
权限错误
确认 API Token 权限足够
检查用户对目标 Space 有写入权限
使用
confluence_list_spaces验证 Space Key
📚 相关资源
🤝 贡献
欢迎提交 Issue 和 Pull Request!
📄 许可证
MIT
快速链接: