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

Playwrightによるブラウザクッキー認証を使用して、アップストリームのmcp-atlassianツールセットをラップするMCPサーバーです。APIトークンが利用できない企業SSO（Okta、SAMLなど）の背後にあるAtlassian Server/Data Centerインスタンス向けに設計されています。

仕組み

初回使用時（またはセッションの有効期限が切れた時）、Playwrightが手動SSO/MFA用のChromiumウィンドウを起動します
ログイン後、クッキーがPlaywrightのストレージ状態ファイルに保存されます
以降のすべてのMCPツール呼び出しは、カスタムの requests.Session サブクラスを介してそれらのクッキーを使用します
APIレスポンスがSSOリダイレクトのように見える場合、ブラウザが自動的に再起動します

このサーバーは 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`	ランチャー: venvの作成、`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`	有効にするアップストリームツールセット