{"_id":"atlassian-cookie-mcp-server","_rev":"18-0f63ec770e9ec35a3cd02821ddc21c04","name":"atlassian-cookie-mcp-server","dist-tags":{"latest":"2.6.0"},"versions":{"0.0.0-stage":{"name":"atlassian-cookie-mcp-server","version":"0.0.0-stage","_id":"atlassian-cookie-mcp-server@0.0.0-stage","stub":true,"maintainers":[{"name":"xxaof","email":"1564733651@qq.com"}],"dist":{"shasum":"71bf4a95d42bbc10f6a31e4a8e8e7b619d9c1254","tarball":"https://registry.npmjs.org/atlassian-cookie-mcp-server/-/atlassian-cookie-mcp-server-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-Gzui46KW+IREegm1wKRil+sPzzeybVEPaot1a50LSzC3tI9v8TZbAddhjT2qf/O+Jot1uVRnkYBzwA3D6OlSrw==","signatures":[{"sig":"MEUCIQCKkHHeEnTESXhrE3VgZX5Hc0VsOfk1vRkJ2S53UoRIswIgGkRN4icq1gJ6Iuep9Iv70Pr4JvALYjpuyKqhGLMyXLw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":349},"_npmUser":{"name":"xxaof","email":"1564733651@qq.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"2.4.0":{"name":"atlassian-cookie-mcp-server","version":"2.4.0","keywords":["mcp","model-context-protocol","jira","confluence","atlassian","cursor","claude"],"author":{"name":"xxaof"},"license":"MIT","_id":"atlassian-cookie-mcp-server@2.4.0","maintainers":[{"name":"xxaof","email":"1564733651@qq.com"}],"bin":{"atlassian-cookie-mcp-server":"src/index.js"},"dist":{"shasum":"ffe6e8ee6212c972d6f4b920f910482d44ed09f1","tarball":"https://registry.npmjs.org/atlassian-cookie-mcp-server/-/atlassian-cookie-mcp-server-2.4.0.tgz","fileCount":9,"integrity":"sha512-jJmveqHAUNdioSkgx29HBGmCkBbPs5l4o0pfQF0khtZ7o711floje/3m/1saLyOASt1vjYhSgGfxjFTdo4sRag==","signatures":[{"sig":"MEYCIQDnUD5EUntPCTaQ21/V1tojcq/c3mq008PvY9Pm76vkrgIhAO8K/AVK8mRmPn3VE8Rj6D0cEXq4egkZFlByHHo/hrha","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIDpEN/kAUlKrZxb7PAS4HSjbi7f3wNgOlhtiC7sSEqPRAiBHZuqScYF4+lPwLMTPwFMgYsI+Jz122pvSnGqlS8hj3g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":112649},"type":"module","engines":{"node":">=22"},"gitHead":"e6f134144d5bd261e8e8fce9056340280e55cb9d","scripts":{"check":"node --check src/index.js && node --check src/session.js && node --check src/browser-login.js && node --check src/confirm.js && node --check src/jira.js && node --check src/confluence.js","login":"node src/index.js --login","start":"node src/index.js","prepublishOnly":"npm run check"},"_npmUser":{"name":"xxaof","email":"1564733651@qq.com"},"_npmVersion":"10.9.3","description":"MCP server for Jira and Confluence (Server / Data Center): browser-cookie login (no password), read-only by default, server-enforced in-chat confirmation for every write.","directories":{},"_nodeVersion":"22.20.0","dependencies":{"@modelcontextprotocol/sdk":"^1.32.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/atlassian-cookie-mcp-server_2.4.0_1792657383888_0.08369197908613213","host":"s3://npm-registry-packages-npm-production"}},"2.5.0":{"name":"atlassian-cookie-mcp-server","version":"2.5.0","keywords":["mcp","model-context-protocol","jira","confluence","atlassian","cursor","claude"],"author":{"name":"xxaof"},"license":"MIT","_id":"atlassian-cookie-mcp-server@2.5.0","maintainers":[{"name":"xxaof","email":"1564733651@qq.com"}],"bin":{"atlassian-cookie-mcp-server":"src/index.js"},"dist":{"shasum":"d9bd089a3c2caf790574ed82fae556f3b08a646b","tarball":"https://registry.npmjs.org/atlassian-cookie-mcp-server/-/atlassian-cookie-mcp-server-2.5.0.tgz","fileCount":10,"integrity":"sha512-gFiCB44MFetUtQoqq2AunIbcd32WlUt7A7H/Y3567sKBqI1fxnl1h5wEbJ5b/HN+LI6y6lKrOkOP6WMxBepjlw==","signatures":[{"sig":"MEQCIDMKPlm2G0FG5dlAAXHypAkSWUFcfpvP+ts0mrjeE6GqAiAjg37NEw0XI0U6k76CuNmvJUSUAWp3vbEIOziXX6kn7A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIC6twxDXmYTBSDQIziiBnvMySVNgylG+Kh9eCzlt5yp+AiEAixDWImp8vl4nw5J6a6CWpN8pT0foe/SyB05tsYkECrY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":123282},"type":"module","engines":{"node":">=22"},"gitHead":"4b0763cbde2a733a1cebf1b6650cf0477fa3dcc9","scripts":{"test":"node scripts/test-confirm.mjs && node scripts/test-markdown.mjs","check":"node --check src/index.js && node --check src/session.js && node --check src/browser-login.js && node --check src/confirm.js && node --check src/jira.js && node --check src/confluence.js","login":"node src/index.js --login","start":"node src/index.js","prepublishOnly":"npm run check && npm test"},"_npmUser":{"name":"xxaof","email":"1564733651@qq.com"},"_npmVersion":"10.9.3","description":"MCP server for Jira and Confluence (Server / Data Center): browser-cookie login (no password), read-only by default, server-enforced in-chat confirmation for every write.","directories":{},"_nodeVersion":"22.20.0","dependencies":{"@modelcontextprotocol/sdk":"^1.32.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/atlassian-cookie-mcp-server_2.5.0_1792659833077_0.6395215363031841","host":"s3://npm-registry-packages-npm-production"}},"2.6.0":{"_id":"atlassian-cookie-mcp-server@2.6.0","bin":{"atlassian-cookie-mcp-server":"src/index.js"},"dist":{"shasum":"db469498b7aba826dab6bb504dd5ed695e9ba93e","tarball":"https://registry.npmjs.org/atlassian-cookie-mcp-server/-/atlassian-cookie-mcp-server-2.6.0.tgz","fileCount":10,"integrity":"sha512-qvG4X6NEy4mDdeUme/Ge0WBgfVNAWrfISs5QJ9MU4ye14WOZm65vuAm9xMOAPW+OLwsOOjqoGq/qIqaZl9zqNQ==","signatures":[{"sig":"MEYCIQD5XAHZUtTrs+9VeXovt8f/juW7nlloq/QP5QeKS5bXiwIhALGaWwO7p52bR+ArBrI90nULB0YE5q0K0qEXnvyFJTnC","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIC9cqAVpkOXg6TcoLDegy7FwIuWmwpszZVpD6nZYkI3mAiAqyOeqrhfaHDXPFGnmvMKb5popMC2zBGX8afhZOVd6fw=="}],"unpackedSize":110787},"name":"atlassian-cookie-mcp-server","type":"module","author":{"name":"xxaof"},"engines":{"node":">=22"},"gitHead":"66016860b8096d4c5423d00cd4e3d9a436a8579e","license":"MIT","scripts":{"test":"node scripts/test-confirm.mjs && node scripts/test-markdown.mjs","check":"node --check src/index.js && node --check src/session.js && node --check src/browser-login.js && node --check src/confirm.js && node --check src/jira.js && node --check src/confluence.js","login":"node src/index.js --login","start":"node src/index.js","prepublishOnly":"npm run check && npm test"},"version":"2.6.0","_npmUser":{"name":"xxaof","email":"1564733651@qq.com"},"keywords":["mcp","model-context-protocol","jira","confluence","atlassian","cursor","claude"],"_npmVersion":"10.9.3","description":"MCP server for Jira and Confluence (Server / Data Center): browser-cookie login (no password), sensitive write tools carry explicit ask-the-user warnings.","directories":{},"maintainers":[{"name":"xxaof","email":"1564733651@qq.com"}],"_nodeVersion":"22.20.0","dependencies":{"@modelcontextprotocol/sdk":"^1.32.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/atlassian-cookie-mcp-server_2.6.0_1792664639692_0.7858354383985291"}}},"time":{"created":"2026-10-22T03:31:24.195Z","modified":"2026-10-22T10:24:00.400Z","0.0.0-stage":"2026-10-22T03:31:24.195Z","2.1.2":"2026-10-22T03:35:16.180Z","2.1.3":"2026-10-22T03:52:06.815Z","2.1.4":"2026-10-22T05:49:04.566Z","2.1.5":"2026-10-22T06:33:47.934Z","2.1.6":"2026-10-22T06:56:17.918Z","2.2.0":"2026-10-22T07:19:08.025Z","2.3.0":"2026-10-22T08:05:01.909Z","2.4.0":"2026-10-22T08:23:03.979Z","2.5.0":"2026-10-22T09:03:53.146Z","2.6.0":"2026-10-22T10:23:59.768Z"},"author":{"name":"xxaof"},"license":"MIT","keywords":["mcp","model-context-protocol","jira","confluence","atlassian","cursor","claude"],"description":"MCP server for Jira and Confluence (Server / Data Center): browser-cookie login (no password), sensitive write tools carry explicit ask-the-user warnings.","maintainers":[{"name":"xxaof","email":"1564733651@qq.com"}],"readme":"# Atlassian Cookie MCP Server\n\n适用于 Jira / Confluence **Server / Data Center** 的 [MCP](https://modelcontextprotocol.io) 服务。用自然语言让 Cursor、Claude Code、Codex 等 Agent 查询、创建和编辑 Jira 工单与 Confluence 文档。\n\n基于 [`@noiceman/atlassian-mcp-server`](https://www.npmjs.com/package/@noiceman/atlassian-mcp-server)(MIT),主要区别:\n\n- **无需账号密码**:通过浏览器登录,自动获取会话 Cookie,配置里不存任何凭据(支持单点登录)。\n- **不提供删除功能**,也不读写本机文件;修改、移动等敏感工具在描述里要求 Agent 先向用户说明并获得同意。\n- **主动被调用**:工具描述和服务说明内置触发词,提到工单号、Jira / Confluence 链接时 Agent 会自动使用,无需说「用 MCP」。\n\n本服务支持:\n\n- Issue 查询、搜索(JQL)、创建、修改\n- Issue 评论与关联\n- Confluence 页面搜索、读取、创建、修改、移动\n- Confluence 评论、标签、历史版本、页面权限查看\n- Confluence 空间与页面树浏览\n\n## 配置\n\n在 Agent 的 MCP 配置文件中添加(Cursor 为 `~/.cursor/mcp.json`),只配置你用到的服务:\n\n```json\n{\n  \"mcpServers\": {\n    \"atlassian-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"--prefer-online\", \"atlassian-cookie-mcp-server@latest\"],\n      \"env\": {\n        \"JIRA_HOST\": \"https://jira.example.com\",\n        \"CONFLUENCE_URL\": \"https://confluence.example.com\"\n      }\n    }\n  }\n}\n```\n\n重启 Agent。首次使用时会弹出浏览器登录页,登录后窗口自动关闭;也可以运行 `npx atlassian-cookie-mcp-server --login` 提前登录。登录页会自动勾选「记住我」,登录态通常保持约两周,过期后会再次弹出登录页。\n\n### 环境变量\n\n| 变量 | 说明 | 必填 |\n| --- | --- | --- |\n| `JIRA_HOST` | Jira 地址,如 `https://jira.example.com`。设置后才启用 Jira 工具 | 至少填一个 |\n| `CONFLUENCE_URL` | Confluence 地址。设置后才启用 Confluence 工具 | 至少填一个 |\n| `JIRA_LOGIN_URL` / `CONFLUENCE_LOGIN_URL` | 自定义登录页(单点登录场景),默认 `/login.jsp`、`/login.action` | 否 |\n| `JIRA_SSL_STRICT` / `CONFLUENCE_SSL_STRICT` | 自签证书报错时设为 `false` | 否 |\n| `CONFLUENCE_SPACES_FILTER` | 限定搜索的空间,逗号分隔,如 `DEV,TEAM` | 否 |\n| `ATLASSIAN_MCP_BROWSER` | 登录用的浏览器路径,默认自动查找 | 否 |\n| `ATLASSIAN_MCP_HOME` | Cookie 与登录浏览器配置的存放目录,默认 `~/.atlassian-mcp` | 否 |\n\n### 环境要求\n\n- Node.js **22+**(使用内置 `WebSocket`)\n- Edge 或 Chrome(或其他 Chromium 内核浏览器)\n- 能访问 Jira / Confluence 的网络\n\n主要在 Windows 上测试,macOS / Linux 的浏览器查找逻辑测试较少。\n\n## Jira 工具\n\n「敏感」列为「是」的工具,描述中已要求 Agent 调用前先征得用户同意。\n\n| 工具 | 说明 | 必填参数 | 敏感 |\n| --- | --- | --- | --- |\n| `get_issue` | 查看 Issue 详情和评论,支持 Issue Key 或链接 | `issueKey` | 否 |\n| `get_issues` | 列出项目下的 Issue 和子任务 | `projectKey` | 否 |\n| `search_issues` | 用 JQL 跨项目搜索 Issue | `jql` | 否 |\n| `list_fields` | 列出所有字段 | 无 | 否 |\n| `list_issue_types` | 列出 Issue 类型 | 无 | 否 |\n| `list_link_types` | 列出 Issue 关联类型 | 无 | 否 |\n| `get_user` | 按邮箱或用户名查用户 | `email` | 否 |\n| `create_issue` | 创建 Issue 或子任务,可指派 | `projectKey`、`summary`、`issueType` | 否 |\n| `add_comment` | 添加评论 | `issueKey`、`body` | 否 |\n| `create_issue_link` | 关联两个 Issue | `inwardIssueKey`、`outwardIssueKey`、`linkType` | 否 |\n| `edit_issue` | 修改标题、描述、经办人、状态、优先级 | `issueKey` | 是 |\n\n### 参数示例\n\n```typescript\n// 搜索 Issue\n{\n  jql: \"assignee = currentUser() AND resolution = Unresolved ORDER BY updated DESC\",\n  maxResults: 50\n}\n\n// 创建 Issue\n{\n  projectKey: \"PROJECT\",\n  summary: \"Issue 标题\",\n  issueType: \"Task\",        // 或 \"Story\"、\"Bug\" 等,可用 list_issue_types 查询\n  description: \"详细描述\",\n  assignee: \"username\",     // Jira 用户名,可用 get_user 查询\n  priority: \"High\"\n}\n\n// 创建子任务\n{\n  parent: \"PROJECT-123\",\n  projectKey: \"PROJECT\",\n  summary: \"子任务标题\",\n  issueType: \"Subtask\"\n}\n\n// 修改 Issue(只传需要修改的字段)\n{\n  issueKey: \"PROJECT-123\",\n  status: \"In Progress\",    // 状态流转名称\n  priority: \"High\"\n}\n\n// 关联 Issue\n{\n  linkType: \"Blocks\",             // 可用 list_link_types 查询\n  inwardIssueKey: \"PROJECT-124\",  // 被阻塞的 Issue\n  outwardIssueKey: \"PROJECT-123\"  // 阻塞方 Issue\n}\n```\n\n## Confluence 工具\n\n配置了 `CONFLUENCE_URL` 后可用。页面内容在 Confluence 存储格式(XHTML)和 Markdown 之间自动转换。\n\n### 搜索与浏览\n\n| 工具 | 说明 | 必填参数 | 敏感 |\n| --- | --- | --- | --- |\n| `confluence_search` | 用 CQL 或简单文本搜索 | `query` | 否 |\n| `confluence_get_page` | 按页面 ID、链接、短链或标题读取页面 | `page_id`,或 `title` + `space_key` | 否 |\n| `confluence_get_page_children` | 子页面 | `parent_id` | 否 |\n| `confluence_get_space_page_tree` | 空间页面树 | `space_key` | 否 |\n| `confluence_get_spaces` | 空间列表 | 无 | 否 |\n| `confluence_search_user` | 搜索用户 | `query` | 否 |\n\n### 页面管理\n\n| 工具 | 说明 | 必填参数 | 敏感 |\n| --- | --- | --- | --- |\n| `confluence_create_page` | 创建页面 | `space_key`、`title`、`content` | 否 |\n| `confluence_edit_page` | 修改页面(整页覆盖,旧版本保留在历史中) | `page_id`、`title`、`content` | 是 |\n| `confluence_move_page` | 移动页面到其他父页面或空间 | `page_id` | 是 |\n| `confluence_get_page_history` | 读取某个历史版本 | `page_id`、`version` | 否 |\n| `confluence_get_page_restrictions` | 查看页面的查看/编辑限制 | `page_id` | 否 |\n\n### 评论与标签\n\n| 工具 | 说明 | 必填参数 | 敏感 |\n| --- | --- | --- | --- |\n| `confluence_get_comments` | 页面评论 | `page_id` | 否 |\n| `confluence_add_comment` | 添加评论(Markdown) | `page_id`、`body` | 否 |\n| `confluence_get_labels` | 页面标签 | `page_id` | 否 |\n| `confluence_add_label` | 添加标签 | `page_id`、`name` | 否 |\n| `confluence_get_attachments` | 附件列表(仅查看) | `content_id` | 否 |\n\n## 描述字段格式\n\nIssue 的 `description` 和评论支持 Markdown 风格写法,服务端会转成 Jira 的 wiki 标记:\n\n- 段落之间空一行\n- 用 `- ` 表示项目符号,`1. ` 表示编号列表\n- 支持代码块、行内代码、标题\n\n## 安全策略\n\n参考腾讯文档 MCP 的做法,不在服务端强制确认,而是降低破坏性并提醒 Agent 询问用户,所有 Agent 通用:\n\n- **不提供删除**:没有删除 Issue、页面的工具。\n- **不读写本机文件**:没有附件上传、下载工具,服务端不会读取或写入你电脑上的任意路径。\n- **敏感工具带提醒**:修改、移动等工具的描述末尾有「【谨慎使用】……必须先向用户说明并获得明确同意」。\n- **可找回**:`confluence_edit_page` 覆盖前的旧内容保存在页面历史版本中,可用 `confluence_get_page_history` 读取。\n- **MCP 标注**:所有工具带 `readOnlyHint` / `destructiveHint`,客户端自带的审批界面可据此提示。\n\n这是提醒而非强制:服务端无法验证用户是否真的被询问过。需要更强保护时,请在客户端关闭自动运行(Auto-run)。\n\n## 错误处理\n\n服务端会对以下情况返回明确的错误信息:\n\n- Issue Key 无效\n- 缺少必填字段\n- 权限不足\n- 登录态过期(自动弹出登录页,或提示重新登录)\n\n## 提高被调用概率\n\n服务端自带 MCP `instructions`,每个工具的描述也带有来源标签和中英文触发词。提到工单号、Jira / Confluence 链接、工单或 wiki 页面时,Agent 会主动使用,不需要说「用 MCP」。这部分对所有用户自动生效。\n\n如需进一步加强,可把内置的 Cursor 规则写入项目(已有同名文件时不会覆盖):\n\n```bash\nnpx atlassian-cookie-mcp-server --install-rule          # 当前目录\nnpx atlassian-cookie-mcp-server --install-rule <目录>    # 指定项目\n```\n\n规则文件写入 `.cursor/rules/atlassian-mcp.mdc`。要对所有项目生效,可把规则内容粘贴到 Cursor 设置 → Rules → User Rules。\n\n## 安全说明\n\n- Cookie 以明文保存在 `~/.atlassian-mcp/cookies.json`,等同于已登录状态,有效期取决于服务端「记住我」时长。请勿把该目录发给他人;删除它即可退出登录。\n- Cookie 只会发送给配置的 Jira / Confluence 地址,请求其他域名会被拒绝。\n- 为什么不直接读取日常浏览器的 Cookie:Chrome 127+ 和新版 Edge 使用应用绑定加密,且浏览器运行时 Cookie 数据库被锁定,无法稳定读取。所以改用独立的浏览器配置目录,并通过 DevTools 协议读取 Cookie。\n\n## 常见问题\n\n| 现象 | 处理 |\n| --- | --- |\n| 提示「未配置任何服务」 | 设置 `JIRA_HOST` 和/或 `CONFLUENCE_URL` |\n| 没有弹出登录窗口 | 确认已安装 Edge / Chrome,或设置 `ATLASSIAN_MCP_BROWSER` |\n| 登录后仍返回 401 | 删除 `~/.atlassian-mcp/cookies.json` 后重试 |\n| 找不到经办人 | 使用 Jira 用户名,不要用显示名或邮箱 |\n| Agent 不主动使用 | 确认已更新到最新版;可运行 `--install-rule` 加强 |\n\n## 开发\n\n```bash\nnpm run check   # 语法检查\nnpm test        # 工具策略与 Markdown 转换测试\n```\n\n测试不会打开浏览器,也不会访问真实服务。\n\n## 许可证\n\nMIT。原作品版权归 noiceman 所有,修改部分采用相同许可证,详见 [LICENSE](LICENSE)。\n","readmeFilename":"README.md"}