# mcp-atlassian

**Repository Path**: mcpfactory/mcp-atlassian

## Basic Information

- **Project Name**: mcp-atlassian
- **Description**: Model Context Protocol (MCP) server for Confluence & Jira Server/Data Center deployments.
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-24
- **Last Updated**: 2026-05-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MCP Atlassian

Model Context Protocol (MCP) server for Confluence & Jira Server/Data Center deployments.

### Compatibility

| Product        | Deployment Type    | Support Status            |
|----------------|--------------------|---------------------------|
| **Confluence** | Server/Data Center | Supported (version 6.0+)  |
| **Jira**       | Server/Data Center | Supported (version 8.14+) |

## 在 MCP Factory 调试总共分三步

在 MCP Factory 调试 MCP Server 非常简单，找到 main.py 即可一键实现单步调试, 以避免频繁的部署, 提升开发效率。

### 第一步: 创建 Python 环境

首先要创建本地 Python 虚拟环境, 在 requirements.txt 添加依赖, 并且执行以下命令安装依赖

```bash
# 创建本地 Python 虚拟环境, 如果通过 IDE GUI 工具创建过则跳过
uv venv

# 安装依赖
uv pip install -r requirements.txt
```

然后添加解释器

![](images/add-python-interpreter-step1.png)

![](images/add-python-interpreter-step2.png)

### 第二步: 配置构建参数和环境变量

![img.png](images/add-env.png)

您需要添加以下环境变量以实现调试和部署, 其中ACCESS_TOKEN和用户名密码鉴权方式二选一, 对于低版本Jira和Confluence仅支持用户名和密码鉴权.

**方式一：使用 .env 文件（推荐）**

复制 `.env.example` 文件为 `.env` 并填入您的实际配置：

```bash
cp .env.example .env
```

然后编辑 `.env` 文件，填入您的实际环境配置。应用启动时会自动加载 `.env` 文件中的环境变量。

**方式二：直接配置系统环境变量**

您也可以直接在 IDE 或系统中配置环境变量。系统环境变量的优先级高于 `.env` 文件。

**支持的环境变量：**

| 环境变量                     | 说明                                         | 示例值                       |
| ---------------------------- | -------------------------------------------- | ---------------------------- |
| JIRA_URL                     | Jira 服务器地址                              | https://jira.example.com     |
| CONFLUENCE_URL               | Confluence 服务器地址                        | https://docs.example.com     |
| ATLASSIAN_USERNAME           | Atlassian 用户名                             | foo                          |
| ATLASSIAN_PASSWORD           | Atlassian 密码（支持明文或 Base64 编码）     | password 或 cGFzc3dvcmQ=     |
| ATLASSIAN_API_TOKEN          | API Token（替代密码）                        | your-api-token               |
| ATLASSIAN_OAUTH_ACCESS_TOKEN | OAuth Access Token（Jira）                   | your-access-token            |
| ATLASSIAN_OAUTH_TOKEN        | OAuth Token（Jira）                          | your-oauth-token             |
| CONFLUENCE_OAUTH_TOKEN       | OAuth Token（Confluence）                    | your-confluence-oauth-token  |
| ATLASSIAN_CLOUD_ID           | Cloud ID（Atlassian Cloud）                  | your-cloud-id                |
| JIRA_PROJECTS_FILTER         | Jira 项目过滤（逗号分隔）                    | PROJECT1,PROJECT2            |
| CONFLUENCE_SPACES_FILTER     | Confluence 空间过滤（逗号分隔）              | SPACE1,SPACE2                |

**密码安全说明：**
- `ATLASSIAN_PASSWORD` 支持明文密码或 Base64 编码的密码
- 系统会自动检测并解码 Base64 编码的密码
- Base64 编码**不是加密**，只是编码方式，建议使用更安全的密钥管理系统


### 第三步: 启动运行或调试

最后启动 main.py 的 __name__ 函数入口即可.