AI导哈

Atlassian OAuth服务

一个为Jira和Confluence提供安全的OAuth工具和资源访问的Python服务器，支持本地编辑器集成和远程连接。

  • by divakar2206
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 divakar2206/mcp-atlassian-oauth

使用说明

Atlassian OAuth MCP（Python）

一个Atlassian MCP服务器，为Jira和Confluence提供安全、支持OAuth的工具和资源访问。该服务器旨在支持本地编辑器集成（stdio）以及远程连接（HTTP），同时确保组织凭据和每个用户的默认设置清晰分离。

  • 语言：Python（>= 3.10）
  • 许可证：UPL-1.0
  • 入口点：运行 `python -m mcp_atlassian_oauth`
  • 市场元数据：mcp.json（ID：atlassian.oauth）
  • 支持的传输方式：
    • 用于本地/编辑器启动的stdio（默认）
    • 通过POST /mcp进行HTTP（可流式传输）（NDJSON/JSON流式传输）

开始入门

此README文件故意省略了安装说明。请参阅专门的安装指南，以获取适用于两种支持模式的完整、可直接复制粘贴的步骤：

  • 本地（stdio）— 通过Cline设置JSON注入环境变量
  • 远程（可流式传输的HTTP）— 服务器/虚拟机上的.env文件

参见： SETUP.md 翻译成中文是：“安装指南.md” 或 “设置说明.md”（具体翻译可能根据上下文略有调整，但基本意思是指一个关于安装或设置的Markdown文档文件）

它的功能

  • 将Jira和Confluence操作作为结构化MCP工具应用于AI系统和编辑器中。
  • 支持通过URI浏览和读取Jira/Confluence中的顶级MCP资源内容。
  • 满足企业TLS/CA要求（MCP_SSL_VERIFY，MCP_CA_BUNDLE）以进行出站HTTPS通信。
  • 让用户能够定义合理的默认设置（首选用户、项目、空间、输出格式），以简化日常工作流程。

关键能力

  • 交通
    • 为编辑器/代理进程启动使用stdio（默认）
    • 通过 POST /mcp 进行 HTTP（可流式传输）（输入/输出为 JSON/NDJSON）
  • OAuth/Token 支持
    • OAuth刷新流程（客户端ID/密钥 + 刷新令牌）
    • 直接访问令牌（可选）
  • 默认设置（环境或工具）
    • MCP_首选用户, JIRA_默认项目, CONF_默认空间, MCP_默认输出格式
  • 安全与TLS（传输层安全协议）
    • MCP_SSL_VERIFY, MCP_CA_BUNDLE 用于出站HTTPS自定义
    • MCP_HTTP_TRUST_ENV 控制代理环境的使用（设置为 false 以忽略 HTTP(S)_PROXY/NO_PROXY）；为内部网络主机设置 NO_PROXY

用例

  • 开发者生产力：直接在您的编辑器中搜索、分类和评论 Jira 问题。
  • 知识与上下文：将Confluence页面/摘要集成到AI工作流程和代码审查中。
  • 团队工作流程：通过MCP（管理控制面板/多云管理平台等，具体根据上下文确定）标准化项目/空间的默认设置和身份标识。

工具（代表性的）

  • Jira（注：Jira是一个项目管理和问题跟踪工具的名称，直接翻译为中文时通常保留原名，因为它是专有名词。）
    • jira_get_myself — GET /rest/api/latest/myself 翻译为中文是：“获取我的信息 — GET /rest/api/latest/myself”（注：这里的“获取我的信息”是根据Jira API的语境对“GET /rest/api/latest/myself”这一请求的直观解释，实际翻译时可能需要根据具体上下文调整）。不过，为了更贴近API请求的表述，也可以翻译为：“Jira获取当前用户信息接口 — GET /rest/api/latest/myself”
    • jira_search_issues — 使用JQL进行搜索
    • jira_get_issue —— 通过密钥获取问题
    • jira_add_comment — 向问题添加评论
    • jira_find_similar —— 启发式相关问题搜索（可选的语义重排序）
  • “Confluence”翻译成中文是“汇合”或“交汇”。这个词通常用来描述两个或多个事物、想法、观点等的融合或交汇点
    • `conf_get_server_info` — 服务器信息（若未指定则默认为“/”）
    • conf_get_page —— 通过ID获取页面
    • conf_search_cql — 使用CQL进行搜索
  • 公用设施/效用
    • 设置默认值 — 优先用户、默认Jira项目、默认Confluence空间、默认输出格式

资源URI（统一资源标识符）

  • Jira（注：Jira是一个项目管理和问题跟踪工具的名称，直接翻译为中文即为“Jira”，因其作为专有名词，通常不进行意译）
    • Jira://{项目密钥}
    • Jira://{项目密钥}/问题
    • jira://{项目密钥}/issues/{问题密钥}
  • Confluence（此处可译为“汇聚”或根据上下文具体含义翻译，但“Confluence”本身常指“汇流、交汇”之意）
    • Confluence://{空间密钥}
    • Confluence://{空间密钥}/页面
    • confluence://{空间密钥}/pages/{标题}（URL编码）
  • 输出格式
    • Markdown（默认）、JSON、存储（Confluence）

设置与操作

见 SETUP.md 翻译为中文是：“设置指南.md” 或 “安装说明.md”（具体翻译可能根据上下文有所调整，但基本意思是指一个关于设置或安装的Markdown文件） for:（中文可译为“对于”或“为了”，具体根据上下文确定）

  • 安装紫外线（设备/装置）
  • 通过Cline设置JSON（由Cline注入环境变量）进行本地/编辑器使用（stdio）
  • 通过远程/URL使用（HTTP） .env 在虚拟机上运行并执行uv（注：这里的“uv”可能是一个特定命令或程序的名称，具体含义需根据上下文确定，此处直译为“uv”）
  • 反向代理指南与故障排除

安全注意事项

  • 在服务器上保留组织凭据以用于HTTP模式；不要在客户端配置中放置组织机密。
  • 优先使用OAuth刷新令牌流程，而非长期有效的访问令牌。
  • 使用 MCP_SSL_VERIFY=true 和 MCP_CA_BUNDLE 来信任企业证书颁发机构 (CA)。

许可证

UPL-1.0。详见LICENSE文件。

相关 MCP