AI导哈

Confluence MCP服务器

基于Spring Boot 4.0构建的企业级Confluence MCP服务器，提供标准的Model Context Protocol接口，支持Confluence内容搜索和页面访问。

  • by Hiohk
  • Java
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Hiohk/confluence-mcp-server

使用说明

Confluence MCP Server

基于Spring Boot 4.0构建的企业级Confluence MCP服务器，提供标准的Model Context Protocol接口，支持Confluence内容搜索和页面访问。

✨ 核心特性

  • 标准化MCP协议：完全遵循Model Context Protocol规范
  • 企业级架构：模块化设计，清晰的职责分离
  • 高性能HTTP客户端：连接池管理，超时控制
  • 完整测试覆盖：单元测试 + 集成测试 + CI/CD流水线
  • 生产就绪：完善的异常处理、日志监控和安全配置

🛠️ 技术栈

组件 技术选型
开发语言 Java 17+
核心框架 Spring Boot 4.x
MCP协议支持 Spring AI MCP
构建工具 Maven
测试框架 JUnit 5, Mockito
HTTP客户端 Apache HttpClient 5

🚀 快速开始

环境要求

  • JDK 17 或更高版本
  • Maven 3.6+
  • Confluence服务器访问权限

安装部署

# 1. 克隆项目
git clone https://github.com/your-org/confluence-mcp-server.git
cd confluence-mcp-server

# 2. 构建项目
mvn clean package

# 3. 配置环境变量
export CONFLUENCE_URL=your_confluence_url
export CONFLUENCE_USERNAME=your_username
export CONFLUENCE_PASSWORD=your_password

# 4. 运行应用
java -jar target/confluence-mcp-server-*.jar

# 开发模式
mvn spring-boot:run

⚙️ 配置说明

创建 application.yml 或使用环境变量：

server:
  port: 9091

spring:
  application:
    name: confluence-mcp-server
  ai:
    mcp:
      server:
        enabled: true
        name: confluence_mcp_server
        version: 1.0.0
        sse-endpoint: /mcp/sse
        sse-message-endpoint: /api/v1/mcp

confluence:
  url: ${CONFLUENCE_URL:https://your-confluence.com}
  username: ${CONFLUENCE_USERNAME}
  password: ${CONFLUENCE_PASSWORD}
  default-space: ${CONFLUENCE_DEFAULT_SPACE:RP}
  default-content-type: ${CONFLUENCE_DEFAULT_CONTENT_TYPE:page,blogpost}
  default-search-limit: ${CONFLUENCE_DEFAULT_SEARCH_LIMIT:10}
  connection-timeout: ${CONFLUENCE_CONNECTION_TIMEOUT:30000}
  read-timeout: ${CONFLUENCE_READ_TIMEOUT:30000}

📡 MCP工具接口

searchConfluence

在Confluence中搜索内容

参数：

  • searchKeyword: 搜索关键词（必需）
  • space: 空间标识
  • contentType: 内容类型（page/blogpost）
  • limit: 结果数量限制

getConfluencePage

获取指定页面内容

参数：

  • pageId: Confluence页面ID（必需）

🏗️ 项目结构

src/
├── main/
│   ├── java/com/confluence/mcp/
│   │   ├── config/           # 配置类
│   │   │   ├── ConfluenceConfig.java
│   │   │   ├── HttpClientConfig.java
│   │   │   └── McpConfig.java
│   │   ├── exception/        # 异常处理
│   │   │   ├── ConfluenceException.java
│   │   │   └── ExceptionHandlerUtil.java
│   │   ├── tool/            # MCP工具实现
│   │   │   └── ConfluenceTool.java
│   │   ├── util/            # 工具类
│   │   │   ├── HttpClientUtil.java
│   │   │   └── JsonParserUtil.java
│   │   └── ConfluenceMcpServerApplication.java
│   └── resources/
│       └── application.yml
└── test/
    └── java/com/confluence/mcp/
        └── tool/            # 测试类
            ├── ConfluenceToolMockTest.java
            └── ConfluenceToolTest.java

🧪 测试

# 运行所有测试
mvn test

# 运行特定测试类
mvn test -Dtest=ConfluenceToolTest

# 生成测试报告
mvn jacoco:report

🔧 开发规范

  • 代码风格：遵循Google Java风格指南
  • 异常处理：统一使用ConfluenceException业务异常
  • 日志规范：SLF4J + 统一格式
  • 配置管理：环境变量注入敏感信息

📦 CI/CD流程

GitHub Actions自动化流水线包含：

  1. 代码编译和依赖检查
  2. 单元测试和集成测试
  3. 代码质量扫描
  4. 安全漏洞检测

🚨 安全注意事项

  • 🔐 使用环境变量管理Confluence凭证
  • 🛡️ 所有输入参数进行验证和过滤
  • ⏱️ 配置合理的网络超时时间
  • 📊 启用详细的访问日志和监控

📄 License

MIT License - 详见 LICENSE 文件

🤝 贡献

欢迎提交Issue和Pull Request！贡献前请确保：

  • 代码符合项目代码风格
  • 包含相应的单元测试
  • 更新相关文档

相关 MCP