Confluence MCP 服务器

Confluence MCP 服务器是一个模型上下文协议(MCP)服务器,使AI助手能够与Confluence交互,将Markdown文档转换为具有专业样式的Confluence页面,并支持Mermaid图表。

  • by manateeit
  • 1 星标
  • 更新于
在 GitHub 查看 manateeit/confluence-mcp

使用说明

基本能力

产品定位

Confluence MCP 服务器是一个专为AI助手设计的中间件,用于高效地将Markdown内容转换为Confluence页面,支持实时更新和图表渲染。

核心功能

  • 🔄 SSE 服务器: 实时服务器发送事件,用于实时进度更新
  • 📝 Markdown 转 Confluence: 将Markdown内容转换为Confluence存储格式
  • 📊 Mermaid 图表: 在Confluence页面中渲染Mermaid图表为图片
  • 🎨 专业样式: 现代、简洁的页面布局
  • 💾 智能缓存: 本地缓存,用于链接Markdown文件和Confluence页面
  • 🔒 安全认证: Confluence API 令牌认证
  • ☁️ Fly.io 就绪: 优化以在Fly.io上部署

适用场景

  • 团队协作文档管理
  • 自动化文档生成与更新
  • 技术文档的实时同步
  • 图表与文档的集成展示

工具列表

  • confluence_list_spaces - 列出所有可用的Confluence空间
  • confluence_list_pages - 列出特定空间中的页面
  • confluence_create_page - 从Markdown内容创建新页面
  • confluence_update_page - 用新内容更新现有页面
  • confluence_delete_page - 删除页面并清理缓存

使用教程

使用依赖

  1. 确保已安装Node.js和npm
  2. 确保已安装Git

安装教程

git clone <repository-url>
cd confluence-mcp
npm install

配置

复制示例环境文件并配置您的Confluence凭证:

cp .env.example .env

编辑.env文件,填写您的Confluence详细信息:

CONFLUENCE_BASE_URL=https://your-domain.atlassian.net
CONFLUENCE_USERNAME=your-email@domain.com
CONFLUENCE_API_TOKEN=your-api-token
MCP_API_KEY=your-mcp-api-key
PORT=3001

获取Confluence API令牌

  1. 访问Atlassian账户设置
  2. 点击“创建API令牌”
  3. 为其命名并复制令牌
  4. 使用您的邮箱作为用户名,令牌作为密码

运行服务器

# 开发模式
npm run dev

# 生产模式
npm run build
npm start

服务器将在http://localhost:3001上可用

调试方式

# 测试健康端点
curl http://localhost:3001/health

# 测试SSE连接
curl -N http://localhost:3001/mcp