阿特拉斯-MCP

Name: 阿特拉斯-MCP
Author: xuanxt

作者：xuanxt2 星标更新：2025-11-09

安装使用来源：spider==github.com

项目介绍

Atlassian MCP 服务器

Atlassian Confluence 和 Jira Cloud 的 Model Context Protocol (MCP) 服务器。提供 51 种工具来管理 Confluence 页面、Jira 问题、冲刺、看板和待办事项。支持 NPM 包和 Docker 部署，并具有灵活的身份验证。

概览

提供了 51 种工具（13 种用于 Confluence，38 种用于 Jira），允许与 MCP 兼容的 AI 助手管理您的 Atlassian Cloud 工作区。

您可以做什么

Confluence (13 种工具)

空间与页面管理：列出、创建、更新、删除空间和页面
内容搜索：使用 CQL（Confluence 查询语言）搜索页面
评论：添加和管理页面上的评论
内容层次结构：获取页面内容、祖先、子页面和完整的层次结构

Jira (38 种工具)

问题管理：创建、更新、转换、分配和删除问题
冲刺操作：创建、启动、关闭和删除冲刺；在冲刺之间移动问题
看板管理：创建、配置和管理 Scrum/Kanban 看板
待办事项管理：对问题进行排名，从待办事项中移入移出，管理冲刺分配
史诗管理：创建史诗，将问题分配给史诗，管理史诗工作流
时间跟踪：添加、更新和删除工时记录
搜索：支持 JQL（Jira 查询语言）
版本管理：创建、更新和删除项目版本
问题链接：链接相关问题
批量操作：一次更新多个问题

特性

51 种工具：页面、问题、看板、冲刺的完整 CRUD 操作
多种部署方式：NPM 包、Docker 容器、本地构建
IDE 支持：Claude Desktop、Cursor、Claude Code、VS Code (Cline)、Windsurf
灵活配置：配置文件、环境变量或命令行参数
使用 TypeScript 构建：通过 MCP SDK 实现类型安全

快速开始

方法 1：使用 npx（推荐）

无需安装，直接从 npm 注册表运行：

# 使用默认配置文件（~/.atlassian-mcp.json）运行
npx @xuandev/atlassian-mcp

# 使用自定义配置文件运行
npx @xuandev/atlassian-mcp --config /path/to/config.json

# 使用环境变量运行
ATLASSIAN_DOMAIN="your-domain.atlassian.net" \
ATLASSIAN_EMAIL="your-email@example.com" \
ATLASSIAN_API_TOKEN="your-api-token" \
npx @xuandev/atlassian-mcp

# 使用命令行参数运行
npx @xuandev/atlassian-mcp \
  --domain your-domain.atlassian.net \
  --email your-email@example.com \
  --token your-api-token

前提条件：

创建 ~/.atlassian-mcp.json 配置文件（参见配置）
或设置环境变量
或使用命令行参数

方法 2：全局安装

# 使用 npm
npm install -g @xuandev/atlassian-mcp

# 使用 bun
bun install -g @xuandev/atlassian-mcp

# 使用配置文件运行（推荐）
atlassian-mcp

# 使用自定义配置运行
atlassian-mcp --config /path/to/config.json

# 使用环境变量运行
ATLASSIAN_DOMAIN="your-domain.atlassian.net" \
ATLASSIAN_EMAIL="your-email@example.com" \
ATLASSIAN_API_TOKEN="your-api-token" \
atlassian-mcp

# 使用命令行参数运行
atlassian-mcp \
  --domain your-domain.atlassian.net \
  --email your-email@example.com \
  --token your-api-token

方法 3：Docker（容器化部署）

使用 Docker Hub 上发布的镜像：

# 拉取镜像
docker pull xuanxdev/atlassian-mcp:latest

# 使用配置文件运行（推荐）
docker run -i --rm \
  -v .atlassian-mcp.json:/config/.atlassian-mcp.json:ro \
  xuanxdev/atlassian-mcp:latest

# 使用环境变量运行
docker run -i --rm \
  -e ATLASSIAN_DOMAIN="your-domain.atlassian.net" \
  -e ATLASSIAN_EMAIL="your-email@example.com" \
  -e ATLASSIAN_API_TOKEN="your-api-token" \
  xuanxdev/at-lassian-mcp:latest

# 使用命令行参数运行
docker run -i --rm xuanxdev/atlassian-mcp:latest \
  --domain your-domain.atlassian.net \
  --email your-email@example.com \
  --token your-api-token

本地构建：

# 构建 Docker 镜像
docker build -t xuanxdev/atlassian-mcp:1.0.0 -t xuanxdev/atlassian-mcp:latest .

# 运行本地构建的镜像
docker run -i --rm \
  -v /absolute/path/to/.atlassian-mcp.json:/config/.atlassian-mcp.json:ro \
  xuanxdev/atlassian-mcp:latest

配置

此 MCP 服务器支持以下三种配置方法，优先级如下：

命令行参数（最高优先级）
环境变量
配置文件（最低优先级）

获取 Atlassian API Token

在配置之前，您需要一个 API Token：

访问 https://id.atlassian.com/manage-profile/security/api-tokens
点击 "创建 API Token"
输入名称并创建
复制令牌（仅显示一次，请安全保存）

方法 1：配置文件（推荐）

默认配置文件位置

服务器会自动按以下顺序搜索配置文件：

~/.atlassian-mcp.json（用户主目录 - 推荐）
~/.config/atlassian-mcp/config.json（XDG 配置目录）
./.atlassian-mcp.json（当前工作目录）

配置文件格式：

{
  "domain": "your-domain.atlassian.net",
  "email": "your-email@example.com",
  "apiToken": "your-api-token-here"
}

安全提示：为您的配置文件设置严格的权限：

chmod 600 ~/.atlassian-mcp.json

方法 2：环境变量

Linux/macOS：

export ATLASSIAN_DOMAIN="your-domain.atlassian.net"
export ATLASSIAN_EMAIL="your-email@example.com"
export ATLASSIAN_API_TOKEN="your-api-token-here"

方法 3：命令行参数

atlassian-mcp --domain your-domain.atlassian.net \
              --email your-email@example.com \
              --token your-api-token-here

可用选项：

-c, --config <path> - 配置文件路径
-d, --domain <domain> - Atlassian 域名
-e, --email <email> - 账户邮箱
-t, --token <token> - API 令牌
-V, --version - 显示版本
-h, --help - 显示帮助

MCP 客户端配置

常用配置示例

使用 NPM 包（推荐）

使用配置文件（相对路径）：

{
  "mcpServers": {
    "atlassian": {
      "command": "npx",
      "args": [
        "-y",
        "@xuandev/atlassian-mcp",
        "--config",
        ".atlassian-mcp.json"
      ]
    }
  }
}

使用环境变量：

{
  "mcpServers": {
    "atlassian": {
      "command": "npx",
      "args": ["-y", "@xuandev/atlassian-mcp"],
      "env": {
        "ATLASSIAN_DOMAIN": "your-domain.atlassian.net",
        "ATLASSIAN_EMAIL": "your-email@example.com",
        "ATLASSIAN_API_TOKEN": "your-api-token"
      }
    }
  }
}

使用 Docker 容器

使用配置文件（相对路径）：

{
  "mcpServers": {
    "atlassian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        ".atlassian-mcp.json:/config/.atlassian-mcp.json:ro",
        "xuanxdev/atlassian-mcp:latest"
      ]
    }
  }
}

使用环境变量：

{
  "mcpServers": {
    "atlassian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ATLASSIAN_DOMAIN=your-domain.atlassian.net",
        "-e",
        "ATLASSIAN_EMAIL=your-email@example.com",
        "-e",
        "ATLASSIAN_API_TOKEN=your-api-token",
        "xuanxdev/atlassian-mcp:latest"
      ]
    }
  }
}

完整工具参考

Confluence 工具（总计 13 种）

空间管理

1. confluence_list_spaces

描述：列出所有 Confluence 空间
参数：
- maxResults（可选，数字）：返回的最大结果数（默认：25）
- startAt（可选，数字）：分页起始索引（默认：0）
返回值：包含 ID、键、名称、类型、状态的空间数组

2. confluence_search

描述：使用 CQL（Confluence 查询语言）搜索 Confluence 内容
参数：
- cql（必需，字符串）：CQL 查询字符串（例如："type=page AND space=TEAM"）
- maxResults（可选，数字）：最大结果数（默认：25）
- startAt（可选，数字）：分页偏移量（默认：0）
- expand（可选，字符串数组）：要展开的字段（例如：["body.view", "version", "space"]）
返回值：带有内容详情的搜索结果
CQL 示例：
- type=page AND title~"API" - 搜索标题中含有 "API" 的页面
- space=TEAM AND lastModified>now("-7d") - 最近 7 天内修改过的页面
- creator=currentUser() - 当前用户创建的内容

页面管理

3. confluence_list_pages

描述：列出空间中的页面
参数：
- spaceId（必需，字符串）：空间 ID
- maxResults（可选，数字）：最大结果数（默认：25）
- startAt（可选，数字）：分页偏移量（默认：0）
返回值：包含 ID、标题、状态、位置的页面数组

4. confluence_get_page

描述：获取详细页面信息
参数：
- pageId（必需，字符串）：页面 ID
- bodyFormat（可选，字符串）：正文格式 - "storage"（原始 HTML）、"atlas_doc_format"（JSON）、"view"（渲染 HTML）、"export_view"（导出格式）
- version（可选，数字）：特定版本号（省略表示最新版本）
返回值：包括以下内容的完整页面数据：
- 基本信息：ID、状态、标题、空间 ID
- 内容：请求格式的正文
- 元数据：版本、创建/修改日期、作者
- 关系：父页面、子页面

5. confluence_get_page_children

描述：获取页面的子页面
参数：
- pageId（必需，字符串）：父页面 ID
- maxResults（可选，数字）：最大结果数（默认：25）
- startAt（可选，数字）：分页偏移量（默认：0）
返回值：子页面数组

6. confluence_create_page

描述：创建新页面
参数：
- spaceId（必需，字符串）：目标空间 ID
- title（必需，字符串）：页面标题
- body（必需，字符串）：页面内容（存储格式 HTML 或 atlas_doc_format JSON）
- parentId（可选，字符串）：父页面 ID（用于层级关系）
- status（可选，字符串）："current" 或 "draft"（默认："current"）
返回值：创建的页面及其详细信息

7. confluence_update_page

描述：更新现有页面
参数：
- pageId（必需，字符串）：要更新的页面 ID
- title（可选，字符串）：新标题
- body（可选，字符串）：新内容
- version（必需，数字）：当前版本号（用于乐观锁定）
- status（可选，字符串）："current" 或 "draft"
返回值：更新后的页面详细信息
注意：需要当前版本号以防止冲突

8. confluence_delete_page

描述：删除页面（移到回收站）
参数：
- pageId（必需，字符串）：要删除的页面 ID
返回值：确认消息
注意：可以从回收站恢复页面

用户管理

9. confluence_search_user

描述：搜索 Confluence 用户
参数：
- query（必需，字符串）：搜索查询（姓名、电子邮件或显示名称）
- maxResults（可选，数字）：最大结果数（默认：25）
- startAt （可选，数字）：分页偏移量（默认：0）
返回值：包含以下内容的用户数组：
- 账户 ID（用于 API 操作）
- 显示名称
- 电子邮件（如果可见）
- 头像
- 账户类型和状态

标签管理

10. confluence_get_labels

描述：获取附加到页面的标签
参数：
- pageId（必需，字符串）：页面 ID
- maxResults（可选，数字）：最大结果数（默认：25）
- startAt（可选，数字）：分页偏移量（默认：0）
返回值：包含 ID 和名称的标签数组

11. confluence_add_label

描述：向页面添加标签
参数：
- pageId（必需，字符串）：目标页面 ID
- labelName（必需，字符串）：标签名称（例如："重要"、"草稿"）
返回值：创建的标签详细信息
注意：如果不存在，则创建标签

评论管理

12. confluence_get_comments

描述：获取页面上的评论
参数：
- pageId（必需，字符串）：页面 ID
- maxResults（可选，数字）：最大结果数（默认：25）
- startAt（可选，数字）：分页偏移量（默认：0）
返回值：包含以下内容的评论数组：
- 评论 ID、正文（存储格式）
- 作者详细信息
- 创建/修改日期
- 父评论 ID（用于回复）

13. confluence_add_comment

描述：向页面添加评论
参数：
- pageId（必需，字符串）：目标页面 ID
- body（必需，字符串）：评论内容（存储格式 HTML）
- parentCommentId（可选，字符串）：父评论 ID（用于回复）
返回值：创建的评论及其 ID
注意：通过 parentCommentId 支持线程评论

Jira 工具（总计 38 种）

项目管理

1. jira_list_projects

描述：列出所有可访问的 Jira 项目
参数：
- maxResults（可选，数字）：最大结果数（默认：50）
- startAt（可选，数字）：分页偏移量（默认：0）
返回值：包含以下内容的项目数组：
- 项目 ID、键、名称
- 项目类型（软件、业务、服务台）