MCP Atlassian

MCP Atlassian

site icon
2025.03.06 3
TypeScriptAtlassian 集成协作工具交流协作
MCP Atlassian 是一个基于 Model Context Protocol (MCP) 的服务,旨在为 AI 代理提供与 Atlassian 产品(如 Confluence 和 Jira)交互的标准化接口。该服务通过一系列工具实现对 Confluence 和 Jira 的搜索、内容获取、项目管理等功能,适用于需要与 Atlassian 生态系统集成的自动化场景。
View on GitHub

Overview

基本能力

产品定位

MCP Atlassian 是一个中间件服务,专注于为 AI 代理提供与 Atlassian 产品(Confluence 和 Jira)交互的能力。

核心功能

  • Confluence 交互
  • 搜索内容(使用 CQL)
  • 获取空间信息
  • 检索特定内容
  • 列出空间中的所有页面

  • Jira 交互

  • 搜索问题(使用 JQL)
  • 获取特定问题的详细信息
  • 列出所有项目或特定项目
  • 获取问题类型

适用场景

  • 自动化文档检索和管理(Confluence)
  • 自动化问题跟踪和项目管理(Jira)
  • AI 代理与 Atlassian 生态系统的集成

工具列表

Confluence 工具

  • search-confluence:使用 CQL 搜索 Confluence 内容
  • get-confluence-space:获取特定 Confluence 空间的信息
  • get-confluence-content:通过 ID 获取特定内容
  • get-confluence-pages:获取空间中所有页面

Jira 工具

  • search-jira-issues:使用 JQL 搜索问题
  • get-jira-issue:通过键获取特定问题
  • get-jira-projects:获取所有项目
  • get-jira-project:通过键获取特定项目
  • get-jira-issue-types:获取所有问题类型

常见问题解答

  • 需要 Atlassian 账户和 API 令牌
  • 支持标准安装和 Docker 容器化部署
  • 通过环境变量配置 Atlassian 凭证

使用教程

使用依赖

  • Node.js (v16 或更高版本)
  • npm 或 yarn
  • Atlassian 账户和 API 令牌
  • Docker(可选,用于容器化部署)

安装教程

标准安装

  1. 克隆仓库: bash git clone https://github.com/yourusername/mcp-atlassian.git cd mcp-atlassian
  2. 安装依赖: bash npm install # 或使用 make make install
  3. 创建 .env 文件并配置 Atlassian 凭证

Docker 安装

  1. 克隆仓库(同上)
  2. 创建 .env 文件(同上)
  3. 构建并运行 Docker 容器: ```bash # 构建 Docker 镜像 make docker-build

# 运行 Docker 容器 make docker-run

# 或使用 Docker Compose make docker-compose ```

调试方式

  1. 启动服务器: ```bash # 使用 npm npm start

# 使用 make make start

# 使用 Docker make docker-run ``` 2. 测试工具功能 3. 检查日志输出

许可证

该项目遵循 MIT 开源许可条款。