Skip to main content
Glama

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),安全插入代码块

📦 项目结构

confluence-node/ ├── index.js # 原始脚本(保留) ├── mcp-server.js # MCP Server 实现 ├── test-connection.js # 连接测试脚本 ├── package.json ├── .env # 配置文件(需要创建) ├── env-example.txt # 配置示例 ├── mcp-config-example.json # Cursor MCP 配置示例 ├── README.md # 项目总览(本文件) ├── QUICKSTART.md # 快速开始指南 ├── MCP_README.md # MCP 详细文档 ├── USAGE_EXAMPLES.md # 使用示例 ├── KMS_ALIAS_README.md # KMS 别名说明 └── CHANGELOG.md # 更新日志

🚀 快速开始

1️⃣ 安装依赖

npm install

2️⃣ 配置环境变量

复制 env-example.txt.env,并填入你的配置:

CONF_BASE_URL=https://your-confluence-instance.atlassian.net CONF_USERNAME=your-email@example.com CONF_PASSWORD=your-api-token CONF_SPACE=YOUR_SPACE_KEY

3️⃣ 配置 Cursor

编辑 ~/.cursor/mcp.json(参考 mcp-config-example.json):

{ "mcpServers": { "confluence": { "command": "node", "args": ["/绝对路径/到/confluence-node/mcp-server.js"], "env": { "CONF_BASE_URL": "你的Confluence地址", "CONF_USERNAME": "你的邮箱", "CONF_PASSWORD": "你的API-Token", "CONF_SPACE": "你的Space-Key" } } } }

4️⃣ 重启 Cursor

完全关闭并重新打开 Cursor。

5️⃣ 开始使用

在 Cursor 中直接对话即可:

帮我在 Confluence 创建一个技术设计文档,标题是"用户认证系统"

📖 文档

🛠️ 可用工具

类别

工具

说明

Space

confluence_list_spaces

列出所有可访问的 Spaces

页面操作

confluence_create_page

创建新页面

confluence_update_page

更新现有页面

confluence_upsert_page

创建或更新(智能判断)

confluence_get_page

获取页面详情

confluence_delete_page

删除页面

搜索

confluence_search_pages

搜索页面

confluence_get_child_pages

获取子页面

confluence_get_page_history

查看页面历史

confluence_build_code_macro

生成 Confluence Code Macro(storage format)

💡 使用示例

创建页面

在 Confluence 创建一个会议纪要,标题是"2024 年度规划会议"

搜索页面

搜索所有包含"API"的技术文档

更新页面

更新"用户认证系统"文档,添加密码加密章节

查看 Spaces

列出我可以访问的所有 Confluence Spaces

🔧 开发和测试

测试 MCP Server

npm run mcp

使用 MCP Inspector 调试

npx @modelcontextprotocol/inspector node mcp-server.js

查看 Cursor MCP 日志

  • macOS: ~/Library/Logs/Cursor/

  • Windows: %APPDATA%\Cursor\logs\

🐛 故障排查

MCP Server 无法启动

  1. 检查 .env 配置是否正确

  2. 验证 API Token 是否有效

  3. 确认 Confluence URL 可访问

  4. 运行 npm run mcp 查看错误信息

在 Cursor 中看不到 MCP 工具

  1. 检查 ~/.cursor/mcp.json 路径是否正确(必须是绝对路径)

  2. 重启 Cursor(完全退出)

  3. 查看 Cursor 日志文件

权限错误

  1. 确认 API Token 权限足够

  2. 检查用户对目标 Space 有写入权限

  3. 使用 confluence_list_spaces 验证 Space Key

📚 相关资源

🤝 贡献

欢迎提交 Issue 和 Pull Request!

📄 许可证

MIT


快速链接:

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/caijohnny/confluence-node'

If you have feedback or need assistance with the MCP directory API, please join our Discord server