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文件。