Atlassian MCP 服务器

一个用于与 Atlassian JIRA 和 Confluence 集成的 Model Context Protocol (MCP) 服务器。此服务器提供了通过 MCP 协议与 JIRA 工单和 Confluence 页面交互的工具。

功能

• 获取 JIRA 工单详情
• 使用 JQL 搜索 JIRA 工单
• 创建新的 JIRA 工单
• 向 JIRA 工单添加评论
• 获取 Confluence 页面内容
• 在 Confluence 中搜索内容

前提条件

• Node.js 16 或更高版本
• 一个 Atlassian Cloud 账户
• 一个 Atlassian API 令牌

安装

选项 1：从 Cline 市场安装（推荐）

1. 打开 Cline
2. 转到设置 > MCP 服务器
3. 选择“市场”标签
4. 搜索“Atlassian”
5. 点击“安装”
6. 根据提示配置您的 Atlassian 凭证

选项 2：从 npm 安装

npm install -g atlassian-mcp-server

选项 3：从源代码安装

1. 克隆仓库
2. 运行安装脚本：

./install.sh

或者手动：

1. 安装依赖项

npm install

1. 构建项目

npm run build

1. 全局安装

npm install -g .

1. 运行设置

atlassian-mcp-setup

配置

您可以使用设置脚本、配置文件或环境变量来配置服务器。

使用设置脚本（推荐）

运行设置脚本来创建您的配置文件：

npx atlassian-mcp-setup

如果本地安装，则运行：

npm run setup

该脚本将引导您完成配置过程，并在 config 目录中创建一个 config.json 文件。

手动使用配置文件

1. 在 config 目录中创建一个 config.json 文件（您可以从 config.sample.json 复制）
2. 填写您的 Atlassian 详细信息：

{
  "atlassian": {
    "baseUrl": "https://your-instance.atlassian.net",
    "email": "your-email@example.com",
    "token": "your-api-token-here"
  },
  "server": {
    "name": "atlassian-server",
    "version": "0.1.0"
  }
}

使用环境变量

设置以下环境变量：

• ATLASSIAN_BASE_URL：您的 Atlassian 实例 URL（例如，https://your-instance.atlassian.net）
• ATLASSIAN_EMAIL：您的 Atlassian 账户电子邮件
• ATLASSIAN_TOKEN：您的 Atlassian API 令牌
• ATLASSIAN_CONFIG_PATH：（可选）自定义配置文件路径

获取 Atlassian API 令牌

1. 登录到您的 Atlassian 账户 https://id.atlassian.com/manage-profile/security/api-tokens
2. 点击“创建 API 令牌”
3. 为您的令牌命名（例如，“MCP 服务器”）
4. 复制生成的令牌（您之后无法再次查看它）

使用

运行服务器

atlassian-mcp-server

如果从源代码安装：

npm start

与 Cline 集成

选项 1：从市场安装（推荐）

1. 打开 Cline
2. 转到设置 > MCP 服务器
3. 选择“市场”标签
4. 搜索“Atlassian”
5. 点击“安装”
6. 根据提示配置您的 Atlassian 凭证

选项 2：手动配置

如果您已手动安装服务器，请将以下内容添加到您的 MCP 设置中：

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-mcp-server",
      "args": [],
      "env": {
        "ATLASSIAN_CONFIG_PATH": "/path/to/your/config.json"
      },
      "disabled": false
    }
  }
}

或者，您可以在设置中直接提供凭证：

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-mcp-server",
      "args": [],
      "env": {
        "ATLASSIAN_BASE_URL": "https://your-instance.atlassian.net",
        "ATLASSIAN_EMAIL": "your-email@example.com",
        "ATLASSIAN_TOKEN": "your-api-token-here"
      },
      "disabled": false
    }
  }
}

可用工具

get_jira_ticket

通过key获取JIRA工单的详细信息。

参数：

• ticket_key: JIRA工单的key（例如："PROJ-123"）

search_jira_tickets

使用JQL搜索JIRA工单。

参数：

• jql: JQL查询字符串
• max_results: 返回的最大结果数（默认：10）

create_jira_ticket

创建一个新的JIRA工单。

参数：

• project_key: 项目key（例如："PROJ"）
• summary: 工单摘要/标题
• description: 工单描述
• issue_type: 问题类型（例如："Bug", "Task", "Story"）（默认："Task"）

add_comment_to_jira_ticket

向JIRA工单添加评论。

参数：

• ticket_key: JIRA工单的key（例如："PROJ-123"）
• comment: 评论文本

get_confluence_page

通过ID获取Confluence页面。

参数：

• page_id: Confluence页面ID

search_confluence

在Confluence中搜索内容。

参数：

• query: 搜索查询
• limit: 最大结果数（默认：10）

发布到市场

此服务器配置为使用以下GitHub仓库发布到Cline MCP Marketplace:
https://github.com/kompallik/ATLASSIAN-MCP

要发布更新：

1. 使用提供的脚本将更改推送到GitHub仓库：

npm run push-github

1. 如果还没有icon.png文件，请将其添加到assets目录中
2. 运行发布脚本：

npm run publish-mcp

1. 按照提示发布到npm和/或创建分发包
2. 将您的仓库URL提交给Cline MCP Marketplace团队

许可证

MIT