# MCP Atlassian工具 ## 基本信息 - Slug: `sooperset-mcp-atlassian` - Source: modelscope - Publisher: @sooperset/mcp-atlassian - Categories: communication / developer-tools - Hosted: Yes - License: MIT License - Source URL: https://www.modelscope.cn/mcp/servers/@sooperset/mcp-atlassian ## 简介 Model Context Protocol (MCP) 服务器适用于 Atlassian Cloud 产品（Confluence 和 Jira）。此集成是专门为 Atlassian Cloud 实例设计的，不支持 Atlassian Server 或 Data Center 部署。 ## 安装提示 ```bash # Using uv (recommended) brew install uv uvx mcp-atlassian # Using pip pip install mcp-atlassian # Using Docker git clone https://github.com/sooperset/mcp-atlassian.git cd mcp-atlassian docker build -t mcp/atlassian . ``` ## MCP Server 详情 # MCP Atlassian ![PyPI Version](https://img.shields.io/pypi/v/mcp-atlassian) ![PyPI - Downloads](https://img.shields.io/pypi/dm/mcp-atlassian) ![PePy - Total Downloads](https://static.pepy.tech/personalized-badge/mcp-atlassian?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Total%20Downloads) ![License](https://img.shields.io/github/license/sooperset/mcp-atlassian) 用于Atlassian产品（Confluence和Jira）的Model Context Protocol (MCP)服务器。此集成同时支持Confluence & Jira Cloud以及Server/Data Center部署。 ### 功能演示 ![Jira 演示](https://github.com/user-attachments/assets/61573853-c8a8-45c9-be76-575f2b651984)
Confluence 演示 ![Confluence 演示](https://github.com/user-attachments/assets/8a203391-795a-474f-8123-9c11f13a780e)
### 兼容性 | 产品 | 部署类型 | 支持状态 | |---------|----------------|-----------------------------| | **Confluence** | 云端 | ✅ 完全支持 | | **Confluence** | 服务器/数据中心 | ✅ 支持 (版本7.9+) | | **Jira** | 云端 | ✅ 完全支持 | | **Jira** | 服务器/数据中心 | ✅ 支持 (版本8.14+) | ## 设置指南 ### 1. 认证设置 首先，为Confluence & Jira生成必要的认证令牌： #### 对于云端 1. 前往 https://id.atlassian.com/manage-profile/security/api-tokens 2. 点击 **创建API令牌**，命名它 3. 立即复制令牌 #### 对于服务器/数据中心 1. 进入您的个人资料（头像）→ **个人资料** → **个人访问令牌** 2. 点击 **创建令牌**，命名它，设置过期时间 3. 立即复制令牌 ### 2. 安装 选择以下安装方法之一： ```bash # Using uv (recommended) brew install uv uvx mcp-atlassian # Using pip pip install mcp-atlassian # Using Docker git clone https://github.com/sooperset/mcp-atlassian.git cd mcp-atlassian docker build -t mcp/atlassian . ``` ### 3. 配置与使用 您可以使用命令行参数来配置MCP服务器。该服务器支持使用Confluence、Jira或两者服务 - 根据您的使用情况仅包含所需的参数。 #### 必需参数 对于云端： ```bash uvx mcp-atlassian \ --confluence-url https://your-company.atlassian.net/wiki \ --confluence-username your.email@company.com \ --confluence-token your_api_token \ --jira-url https://your-company.atlassian.net \ --jira-username your.email@company.com \ --jira-token your_api_token ``` 对于服务器/数据中心： ```bash uvx mcp-atlassian \ --confluence-url https://confluence.your-company.com \ --confluence-personal-token your_token \ --jira-url https://jira.your-company.com \ --jira-personal-token your_token ``` > **注意：** 您可以只配置Confluence，只配置Jira，或者同时配置两者。只需包含您要使用的服务的参数即可。例如，如果您只想使用Confluence云端，那么只需要`--confluence-url`、`--confluence-username`和`--confluence-token`。 #### 可选参数 - `--transport`: 选择传输类型 (`stdio` [默认] 或 `sse`) - `--port`: SSE 传输的端口号 (默认: 8000) - `--[no-]confluence-ssl-verify`: 切换 Confluence Server/DC 的 SSL 验证 - `--[no-]jira-ssl-verify`: 切换 Jira Server/DC 的 SSL 验证 - `--confluence-spaces-filter`: 逗号分隔的空间键列表，用于过滤 Confluence 搜索结果（例如："DEV,TEAM,DOC"） - `--jira-projects-filter`: 逗号分隔的项目键列表，用于过滤 Jira 搜索结果（例如："PROJ,DEV,SUPPORT"） - `--read-only`: 以只读模式运行（禁用所有写操作） - `--verbose`: 增加日志详细程度（可以多次使用，默认级别为 WARNING） - `-v` 或 `--verbose`: 将日志设置为 INFO 级别 - `-vv` 或 `--verbose --verbose`: 将日志设置为 DEBUG 级别 > **注意：** 所有配置选项也可以通过环境变量设置。请参阅仓库中的 `.env.example` 文件以获取可用环境变量的完整列表。 ## IDE 集成 ### Claude 桌面设置 使用 uvx（推荐）- 云： ```json { "mcpServers": { "mcp-atlassian": { "command": "uvx", "args": [ "mcp-atlassian", "--confluence-url=https://your-company.atlassian.net/wiki", "--confluence-username=your.email@company.com", "--confluence-token=your_api_token", "--jira-url=https://your-company.atlassian.net", "--jira-username=your.email@company.com", "--jira-token=your_api_token" ] } } } ```
使用 uvx（推荐）- 服务器/数据中心 ```json { "mcpServers": { "mcp-atlassian": { "command": "uvx", "args": [ "mcp-atlassian", "--confluence-url=https://confluence.your-company.com", "--confluence-personal-token=your_token", "--jira-url=https://jira.your-company.com", "--jira-personal-token=your_token" ] } } } ```
使用 pip > 注意：以下示例使用的是云配置。对于服务器/数据中心，请使用相应的参数 (--confluence-personal-token, --jira-personal-token)，如上文配置部分所示。 ```json { "mcpServers": { "mcp-atlassian": { "command": "python", "args": [ "-m", "mcp-atlassian", "--confluence-url=https://your-company.atlassian.net/wiki", "--confluence-username=your.email@company.com", "--confluence-token=your_api_token", "--jira-url=https://your-company.atlassian.net", "--jira-username=your.email@company.com", "--jira-token=your_api_token" ] } } } ```
使用 docker > 注意：以下示例使用的是云配置。对于服务器/数据中心，请使用相应的参数 (--confluence-personal-token, --jira-personal-token)，如上文配置部分所示。 有两种方法来配置 Docker 环境： 1. 直接在配置中使用命令行参数： ```json { "mcpServers": { "mcp-atlassian": { "command": "docker", "args": [ "run", "--rm", "-i", "mcp/atlassian", "--confluence-url=https://your-company.atlassian.net/wiki", "--confluence-username=your.email@company.com", "--confluence-token=your_api_token", "--jira-url=https://your-company.atlassian.net", "--jira-username=your.email@company.com", "--jira-token=your_api_token" ] } } } ``` 2. 使用环境文件： ```json { "mcpServers": { "mcp-atlassian": { "command": "docker", "args": [ "run", "--rm", "-i", "--env-file", "/path/to/your/.env", "mcp/atlassian" ] } } } ```
### Cursor IDE 设置 1. 打开 Cursor 设置 2. 导航到 `功能` > `MCP 服务器`（或直接到 `MCP`） 3. 点击 `+ 添加新的全局 MCP 服务器` 这将创建或编辑 `~/.cursor/mcp.json` 文件，其中包含您的 MCP 服务器配置。 ![Cursor MCP 配置](https://github.com/user-attachments/assets/d0901421-7359-4f3f-8330-a82fc574a015) #### stdio 传输的 JSON 配置 对于云： ```json { "mcpServers": { "mcp-atlassian": { "command": "uvx", "args": [ "mcp-atlassian", "--confluence-url=https://your-company.atlassian.net/wiki", "--confluence-username=your.email@company.com", "--confluence-token=your_api…