MCP Atlassian

MCP Atlassian

MCP 服务器处理 Jira 集成。

final-il

开发者工具
访问服务器

README

MCP Atlassian

PyPI 版本 PyPI - 下载量 PePy - 总下载量 许可证 smithery badge

用于 Atlassian 产品（Confluence 和 Jira）的模型上下文协议 (MCP) 服务器。此集成支持 Confluence 和 Jira Cloud 以及 Server/Data Center 部署。

功能演示

Jira 演示

<details> <summary>Confluence 演示</summary>

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

</details>

兼容性

产品 部署类型 支持状态
Confluence Cloud ✅ 完全支持
Confluence Server/Data Center ✅ 支持 (6.0+)
Jira Cloud ✅ 完全支持
Jira Server/Data Center ✅ 支持 (8.14+)

安装指南

1. 身份验证设置

首先，为 Confluence 和 Jira 生成必要的身份验证令牌：

对于 Cloud

  1. 前往 https://id.atlassian.com/manage-profile/security/api-tokens
  2. 点击 创建 API 令牌，命名它
  3. 立即复制令牌

对于 Server/Data Center

  1. 前往您的个人资料（头像）→ 个人资料 → 个人访问令牌
  2. 点击 创建令牌，命名它，设置过期时间
  3. 立即复制令牌

2. 安装

选择以下安装方法之一：

# 使用 uv (推荐)
brew install uv
uvx mcp-atlassian

# 使用 pip
pip install mcp-atlassian

# 使用 Docker
git clone https://github.com/sooperset/mcp-atlassian.git
cd mcp-atlassian
docker build -t mcp/atlassian .

# 使用 Smithery
npx -y @smithery/cli install mcp-atlassian --client claude

3. 配置和使用

您可以使用命令行参数配置 MCP 服务器。该服务器支持使用 Confluence、Jira 或同时使用这两种服务 - 仅包含您的用例所需的参数。

必需参数

对于 Cloud：

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

对于 Server/Data Center：

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 Cloud，您只需要 --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 Desktop 设置

使用 uvx (推荐) - Cloud：

{
  "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"
      ]
    }
  }
}

<details> <summary>使用 uvx (推荐) - Server/Data Center </summary>

{
  "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"
      ]
    }
  }
}

</details>

<details> <summary>使用 uvx - Confluence with Basic Auth (older servers)</summary>

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://confluence.your-company.com",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_password"
      ]
    }
  }
}

</details>

<details> <summary>使用 uvx - Confluence only</summary>

{
  "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"
      ]
    }
  }
}

</details>

<details> <summary>使用 uvx - Jira only</summary>

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

</details>

<details> <summary>使用 pip</summary>

注意：以下示例使用 Cloud 配置。对于 Server/Data Center，请使用相应的参数（--confluence-personal-token，--jira-personal-token），如上面的配置部分所示。

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "mcp-atlassian",
      "args": [
        "--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"
      ]
    }
  }
}

</details>

<details> <summary>使用 docker</summary>

注意：以下示例使用 Cloud 配置。对于 Server/Data Center，请使用相应的参数（--confluence-personal-token，--jira-personal-token），如上面的配置部分所示。

有两种方法可以配置 Docker 环境：

  1. 直接在配置中使用 cli 参数：
{
  "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"
      ]
    }
  }
}
  1. 使用环境变量文件：
{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env-file",
        "/path/to/your/.env",
        "mcp/atlassian"
      ]
    }
  }
}

</details>

Cursor IDE 设置

  1. 打开 Cursor 设置
  2. 导航到 Features > MCP Servers（或直接到 MCP）
  3. 点击 + Add new global MCP server

这将创建或编辑包含您的 MCP 服务器配置的 ~/.cursor/mcp.json 文件。

Cursor MCP 配置

stdio 传输的 JSON 配置

对于 Cloud：

{
  "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"
      ]
    }
  }
}

<details> <summary>Server/Data Center 配置</summary>

{
  "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"
      ]
    }
  }
}

</details>

SSE 传输配置

对于 SSE 传输，首先使用通过命令行参数或服务器端环境变量（例如，来自 .env 文件）提供的配置启动服务器：

# 示例：使用 Cloud 配置启动服务器
uvx mcp-atlassian --transport sse --port 9000 \
  --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

然后在 Cursor 的 ~/.cursor/mcp.json 中仅配置 URL：

{
  "mcpServers": {
    "mcp-atlassian-sse": {
      "url": "http://localhost:9000/sse"
    }
  }
}

资源

注意： MCP 服务器会过滤资源，仅显示用户正在积极交互的 Confluence 空间和 Jira 项目，具体取决于他们的贡献和分配。

  • confluence://{space_key}: 访问 Confluence 空间
  • jira://{project_key}: 访问 Jira 项目

可用工具

工具 描述
confluence_search 使用 CQL 搜索 Confluence 内容
confluence_get_page 获取特定 Confluence 页面的内容
confluence_get_page_children 获取特定 Confluence 页面的子页面
confluence_get_page_ancestors 获取特定 Confluence 页面的父页面
confluence_get_comments 获取特定 Confluence 页面的评论
confluence_create_page 创建新的 Confluence 页面
confluence_update_page 更新现有的 Confluence 页面
confluence_delete_page 删除现有的 Confluence 页面
confluence_attach_content 将内容附加到 Confluence 页面
jira_get_issue 获取特定 Jira 问题的详细信息
jira_search 使用 JQL 搜索 Jira 问题
jira_get_project_issues 获取特定 Jira 项目的所有问题
jira_get_epic_issues 获取链接到特定 Epic 的所有问题
jira_create_issue 在 Jira 中创建新问题
jira_update_issue 更新现有的 Jira 问题
jira_delete_issue 删除现有的 Jira 问题
jira_get_transitions 获取 Jira 问题的可用状态转换
jira_transition_issue 将 Jira 问题转换为新状态
jira_add_comment 向 Jira 问题添加评论
jira_add_worklog 向 Jira 问题添加工作日志条目
jira_get_worklog 获取 Jira 问题的工作日志条目
jira_download_attachments 从 Jira 问题下载附件
jira_link_to_epic 将问题链接到 Epic
jira_get_agile_boards 按名称、项目键或类型获取 Jira agile boards
jira_get_board_issues 获取链接到特定 board 的所有问题
jira_get_sprints_from_board 按状态从 board 获取 Jira sprints
jira_get_sprint_issues 从 sprint 获取 Jira 问题

开发和调试

本地开发设置

如果您已克隆存储库并想要运行本地版本：

对于 Cloud：

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/your/mcp-atlassian",
        "run", "mcp-atlassian",
        "--confluence-url=https://your-domain.atlassian.net/wiki",
        "--confluence-username=your.email@domain.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-domain.atlassian.net",
        "--jira-username=your.email@domain.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

调试工具

# 使用 MCP Inspector
# 对于已安装的软件包
npx @modelcontextprotocol/inspector uvx mcp-atlassian ...

# 对于本地开发版本
npx @modelcontextprotocol/inspector uv --directory /path/to/your/mcp-atlassian run mcp-atlassian ...

# 查看日志
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

安全

  • 永远不要分享 API 令牌
  • 保持 .env 文件安全和私密
  • 有关最佳实践，请参阅 SECURITY.md

许可证

在 MIT 许可下获得许可 - 请参阅 LICENSE 文件。这不是 Atlassian 的官方产品。

推荐服务器

Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页进行交互，而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具，可以从自然语言描述生成现代化的用户界面组件，并与流行的集成开发环境（IDE）集成，从而简化用户界面开发流程。

官方
精选
本地
TypeScript
MCP Package Docs Server

MCP Package Docs Server

促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档，通过多语言支持和性能优化来增强软件开发。

精选
本地
TypeScript
Claude Code MCP

Claude Code MCP

一个实现了 Claude Code 作为模型上下文协议（Model Context Protocol, MCP）服务器的方案，它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力（代码生成、编辑、审查和文件操作）。

精选
本地
JavaScript
@kazuph/mcp-taskmanager

@kazuph/mcp-taskmanager

用于任务管理的模型上下文协议服务器。它允许 Claude Desktop（或任何 MCP 客户端）在基于队列的系统中管理和执行任务。

精选
本地
JavaScript
mermaid-mcp-server

mermaid-mcp-server

一个模型上下文协议 (MCP) 服务器，用于将 Mermaid 图表转换为 PNG 图像。

精选
JavaScript
Jira-Context-MCP

Jira-Context-MCP

MCP 服务器向 AI 编码助手（如 Cursor）提供 Jira 工单信息。

精选
TypeScript
Linear MCP Server

Linear MCP Server

一个模型上下文协议（Model Context Protocol）服务器，它与 Linear 的问题跟踪系统集成，允许大型语言模型（LLM）通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

精选
JavaScript
Sequential Thinking MCP Server

Sequential Thinking MCP Server

这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决，支持修订，并通过完整的 MCP 集成来实现多条解决方案路径。

精选
Python
Curri MCP Server

Curri MCP Server

通过管理文本笔记、提供笔记创建工具以及使用结构化提示生成摘要，从而实现与 Curri API 的交互。

官方
本地
JavaScript