atlassian-browser-mcp

Name: atlassian-browser-mcp
Author: GeiserX

License: GPL-3.0 Python 3.12+ GitHub stars mcp-atlassian GeiserX/atlassian-browser-mcp MCP server

这是一个 MCP 服务器，它通过 Playwright 的浏览器 Cookie 认证封装了上游的 mcp-atlassian 工具集。专为位于企业 SSO（Okta、SAML 等）后方且无法获取 API 令牌的 Atlassian Server/Data Center 实例而设计。

工作原理

首次使用（或会话过期）时，Playwright 会打开一个真实的 Chromium 窗口以进行手动 SSO/MFA 登录
登录后，Cookie 会被保存到 Playwright 的存储状态文件中
所有后续的 MCP 工具调用都会通过自定义的 requests.Session 子类使用这些 Cookie
如果 API 响应看起来像是 SSO 重定向，浏览器会自动重新打开

该服务器通过 monkey-patch（猴子补丁）方式修改了 mcp-atlassian 中的 JiraClient 和 ConfluenceClient 构造函数，以注入基于浏览器的会话，从而与上游工具集保持完全一致（共 72 个工具 + 1 个 atlassian_login 辅助工具 = 总计 73 个）。

文件

文件	用途
`atlassian_browser_mcp_full.py`	入口点。修补上游客户端，注册 `atlassian_login` 工具，运行 MCP 服务器
`atlassian_browser_auth.py`	共享认证：`BrowserCookieSession`，`interactive_login()`，SSO 检测
`run-atlassian-browser-mcp.sh`	启动器：创建虚拟环境，通过 `uv` 安装依赖，运行兼容性检查，启动服务器
`pyproject.toml`	依赖项锁定

使用方法

./run-atlassian-browser-mcp.sh

或者在你的编辑器（Cursor、Claude Code 等）中将其配置为 MCP 服务器，并指向启动脚本。

环境变量

变量	默认值	描述
`JIRA_URL`	(必填)	Jira 基础 URL (例如 `https://jira.example.com`)
`CONFLUENCE_URL`	(必填)	Confluence 基础 URL (例如 `https://confluence.example.com`)
`ATLASSIAN_BROWSER_AUTH_ENABLED`	`true`	启用浏览器认证（设置为 `false` 可回退到令牌认证）
`ATLASSIAN_BROWSER_PROFILE_DIR`	`./.atlassian-browser-profile`	持久化 Chromium 配置文件目录
`ATLASSIAN_STORAGE_STATE`	`./.atlassian-browser-state.json`	Playwright 存储状态文件
`ATLASSIAN_LOGIN_TIMEOUT_SECONDS`	`300`	等待手动登录的秒数
`ATLASSIAN_USERNAME`	(无)	可选：在 SSO 页面预填用户名
`ATLASSIAN_SSO_MARKERS`	(自动)	用于 SSO 重定向检测的逗号分隔 URL/文本标记。默认值涵盖 Okta、ADFS、Azure AD、PingOne、Google SAML
`TOOLSETS`	`all`	要启用的上游工具集