Confluence MCP Test

Confluence MCP 测试

一个概念验证项目，旨在展示Confluence与MCP（模型上下文协议）兼容的AI代理之间的集成。该项目提供了一个基于Docker的设置，其中包括一个Confluence实例和一个MCP适配器服务，用于驱动AI进行文档发现和交互。

🚀 特性

• Confluence Server（服务器版）带有PostgreSQL后端的完整Atlassian Confluence实例
• MCP适配器MCP兼容AI代理的REST API适配器
• 数据播种自动化填充样本空间、页面、评论和附件
• Docker Compose完整的容器化环境，便于快速部署

🏗️ 建筑学

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   AI Agent      │    │   MCP Adapter   │    │   Confluence    │
│                 │◄──►│                 │◄──►│                 │
│                 │    │   (Port 4000)   │    │   (Port 8090)   │
└─────────────────┘    └─────────────────┘    └─────────────────┘
                                │                        │
                                │                        ▼
                                │              ┌─────────────────┐
                                │              │   PostgreSQL    │
                                │              │                 │
                                │              └─────────────────┘
                                ▼
                       ┌─────────────────┐
                       │   Seed Script   │
                       │                 │
                       └─────────────────┘

📋 前提条件

• Docker 和 Docker Compose
• 至少为容器提供4GB可用内存
• 您的系统上可使用端口4000、8090和8091

🛠️ 设置与安装

1. 克隆仓库

git clone 
cd confluence-mcp-test

2. 配置环境变量

复制示例环境文件并更新为您的凭据：

cp .env.example .env

编辑 .env 文件：

CONFLUENCE_BASE_URL=http://localhost:8090
CONFLUENCE_USER=admin
CONFLUENCE_PASS=your_secure_password

3. 启动服务

docker-compose up -d

这将开始：

• PostgreSQL 数据库
• Confluence 服务器
• MCP 适配器服务

4. 初始Confluence设置

1. 等待Confluence启动（这可能需要5-10分钟）
2. 参观 http://localhost:8090
3. 完成Confluence设置向导：

- 选择“生产安装” - 选择“我自己的数据库”并配置 PostgreSQL： - 数据库类型：PostgreSQL - 主机名： confluence-db - 端口： 5432 - 数据库名称： confluence - 用户名： confluence - 密码： confluence - 使用您的凭据创建一个管理员用户 .env 文件 - 完成设置

5. 种子样本数据

一旦Confluence完全配置完毕，请用示例数据进行填充：

docker exec -it mcp-adapter node seed.js

🔧 API 端点

MCP适配器提供以下REST端点：

获取所有空间

GET http://localhost:4000/spaces

获取所有页面

GET http://localhost:4000/pages

搜索内容

GET http://localhost:4000/search?q=your_search_term

📁 项目结构

confluence-mcp-test/
├── docker-compose.yml          # Docker services configuration
├── .env.example               # Environment variables template
├── .gitignore                # Git ignore rules
├── README.md                 # This file
└── mcp-adapter/              # MCP Adapter service
    ├── Dockerfile            # Docker build instructions
    ├── package.json          # Node.js dependencies
    ├── index.js             # Main MCP adapter server
    └── seed.js              # Data seeding script

🧪 样本数据

种子脚本创建：

• 人工智能研究与项目 太空
• 样本页面：

- MCP协议概述 - “Project Atlas”可以翻译为“阿特拉斯计划”或“图谱计划”，具体翻译可能根据上下文和项目具体内容有所调整。在这里，“Atlas”通常指的是一个大型、详尽的图表或信息集合，所以“图谱计划”也是一个合理的翻译选项。不过，由于“Atlas”在不同领域可能有不同的含义，因此在具体翻译时需要考虑其专业背景 - 集成指南

• 每页的评论
• 文本文件附件

🔍 故障排除

Confluence 启动时间过长

• Confluence 需要大量的资源。请确保 Docker 至少分配了 4GB 内存
• 初次启动可能需要10-15分钟

认证问题

• 验证凭据在 .env 文件与您的Confluence管理员用户匹配
• 在运行种子脚本之前，请确保Confluence设置已完成

端口冲突

• 如果端口4000、8090或8091正在被使用，请更新端口映射 docker-compose.yml

数据库连接问题

• 确保PostgreSQL容器正在运行： docker-compose ps
• 检查日志： docker-compose logs confluence-db

🧹 清理

停止并移除所有容器：

docker-compose down

同时移除卷（⚠️这将删除所有Confluence数据）：

docker-compose down -v

🤝 贡献

这是一个概念验证项目。请随意进行分支并根据您的需求进行修改。

📝 许可证

此项目仅为演示目的。请查阅Atlassian的Confluence使用许可条款。

⚠️ 安全通知

• 此设置使用默认凭据，仅适用于开发/测试环境
• 对于生产环境，请实施适当的安全措施：

- 强密码 - HTTPS/TLS 加密 - 网络安全 - 定期更新