MCP 服务器

Atlassian MCP Server

通过模型上下文协议与 Atlassian 产品集成，允许用户与 JIRA 工单和 Confluence 页面进行交互。

README

Atlassian MCP 服务器

一个用于与 Atlassian JIRA 和 Confluence 集成的模型上下文协议 (MCP) 服务器。此服务器提供通过 MCP 协议与 JIRA 问题单和 Confluence 页面交互的工具。

功能

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

前提条件

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

安装

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

打开 Cline
转到 Settings > MCP Servers
选择 "Marketplace" 选项卡
搜索 "Atlassian"
点击 "Install"
出现提示时配置您的 Atlassian 凭据

选项 2：从 npm 安装

npm install -g atlassian-mcp-server

选项 3：从源代码安装

克隆仓库
运行安装脚本：

./install.sh

或者手动：

安装依赖项

npm install

构建项目

npm run build

全局安装

npm install -g .

运行设置

atlassian-mcp-setup

配置

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

使用设置脚本（推荐）

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

npx atlassian-mcp-setup

或者如果本地安装：

npm run setup

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

手动使用配置文件

在 config 目录中创建一个 config.json 文件（您可以从 config.sample.json 复制）
填写您的 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 令牌

登录到您的 Atlassian 帐户：https://id.atlassian.com/manage-profile/security/api-tokens
点击 "Create API token"
为您的令牌命名（例如，"MCP Server"）
复制生成的令牌（您将无法再次看到它）

用法

运行服务器

atlassian-mcp-server

或者如果从源代码安装：

npm start

与 Cline 集成

选项 1：从 Marketplace 安装（推荐）

打开 Cline
转到 Settings > MCP Servers
选择 "Marketplace" 选项卡
搜索 "Atlassian"
点击 "Install"
出现提示时配置您的 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
    }
  }
}