MCP Atlassian 服务器

MCP Atlassian 服务器 (由 phuc-nt 提供)

介绍

**MCP Atlassian Server（由 phuc-nt 提供）**是一个模型上下文协议 (MCP) 服务器，它将 Cline、Claude Desktop 或 Cursor 等 AI 代理连接到 Atlassian Jira 和 Confluence，使它们能够通过标准化界面查询数据和执行操作。

**注意：**该服务器主要针对 Cline 的使用进行设计和优化，但它遵循 MCP 标准并可与其他 MCP 兼容客户端一起使用。

主要特点：
- 将 AI 代理连接到 Atlassian Jira 和 Confluence
- 支持资源（只读）和工具（操作/变异）
- 通过 MCP Marketplace 轻松与 Cline 集成
- 个人开发环境的本地优先设计
- 与 Cline AI 助手的优化集成

这个项目背后的原因

作为一名每天使用 Jira 和 Confluence 的开发人员，我发现自己花费了大量时间在这些工具上。虽然它们功能强大，但我渴望一种更简单的方式与它们交互，而无需在深度工作期间不断切换上下文。

AI 代理和模型上下文协议 (MCP) 的出现带来了绝佳的机会。我立刻看到了将 Jira 和 Confluence（以及 Slack、GitHub、日历等计划）连接到我的 AI 工作流程的潜力。

该项目开始于 MCP 和 AI 代理的学习之旅，但我希望它能够发展成为对每天与 Atlassian 工具交互的个人和组织真正有用的东西。

系统架构

安装和设置

有关详细的安装和设置说明，请参阅我们的AI 助手安装指南。本指南经过特殊格式化，方便 Cline 等 AI/LLM 助手读取并自动设置 MCP Atlassian 服务器。

Cline 用户须知：安装指南 (llms-install.md) 已针对 Cline AI 的理解和执行进行了优化。您只需输入“安装 MCP Atlassian Server (by phuc-nt)”即可，Cline 会自动解析安装说明，并逐步帮助您完成所有设置。

该指南包括：

先决条件和系统要求
Node.js 环境的分步设置
配置 Cline AI 助手以连接 Atlassian
获取并设置 Atlassian API 令牌
安全建议和最佳实践

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Atlassian Integration Server：

npx -y @smithery/cli install @phuc-nt/mcp-atlassian-server --client claude

功能概述

有关所有资源和工具的详细文档，请参阅资源和工具参考

类型	团体	特征	描述	地位
资源	吉拉	查看问题、项目、用户、评论、角色	查询 Jira 数据（JQL、详细信息、列表）	✔
资源	吉拉	过滤器、看板、仪表盘、冲刺	面向开发人员的高级管理	🚧
资源	合流	查看空间、页面、子页面、评论	查询 Confluence 数据	✔
资源	合流	标签、附件、内容版本	高级文档管理	🚧
资源	其他	智能缓存、高级 JQL/CQL、模板	性能、体验、UI 集成	🚧
工具	吉拉	创建、更新、过渡问题	在 Jira 上直接采取行动	✔
工具	合流	创建页面、更新页面（标题、内容、版本、标签）、管理标签、添加评论	在 Confluence 上直接操作（创建、更新、添加/删除标签、评论）	✔
工具	其他	提示、采样、个性化	AI优化、个性化、高级流程	🚧

请求流程

示例用例

安装后尝试向 Cline 询问以下问题：

创建和管理任务
- “在项目 DEMO 中创建关于登录错误的新问题”
- “查找当前冲刺中分配给我的所有问题”
- “将问题 DEMO-43 转换为完成状态”
项目信息摘要
- “总结项目DEMO中的所有问题”
- “项目 DEMO 中的问题分配给了谁？”
- “列出当前冲刺中未分配的问题”
Confluence 文档
- “创建一个名为‘会议记录’的 Confluence 页面”
- 使用新示例和标签更新 Confluence 页面‘API 文档’
- “将标签‘文档’添加到有关架构的页面”
- “从‘会议记录’页面中删除‘草稿’标签”
- “向 Confluence 页面添加有关 API 文档的评论”
分析和报告
- “比较当前冲刺和上一个冲刺中已完成的问题数量”
- “谁的‘待办事项’状态最多？”

这些查询在 Cline 环境中运行效果最佳，并且已通过该 MCP 服务器进行了全面测试。

使用说明

简单的 JQL ：搜索问题时，使用不带空格或特殊字符的简单 JQL（例如， project=DEMO而不是project = DEMO AND key = DEMO-43 ）。
创建 Confluence 页面：创建 Confluence 页面时，请使用简单的 HTML 内容，并且不要指定 parentId，以避免出现错误。
更新 Confluence 页面：更新页面时，请务必包含当前版本号以避免冲突。您还可以更新标签（添加/删除），并且必须使用有效的内容存储格式。
创建问题：创建新问题时，仅提供最少必需字段（projectKey、summary）以获得最佳成功。
访问权限：确保配置的 Atlassian 帐户有权访问您想要交互的项目和空间。

安全说明

您的 API 令牌继承了创建它的用户的所有权限
切勿与不受信任的一方分享您的令牌
要求 LLM 分析包含你的令牌的配置文件时要小心谨慎
请参阅llms-install.md中的详细安全指南

贡献与支持

通过在 GitHub 上打开 Pull 请求或问题来做出贡献。
加入 MCP/Cline 社区以获得更多支持。

**MCP Atlassian Server（由 phuc-nt 提供）**已准备好从 Cline Marketplace 进行一键安装！
请参阅llms-install.md中的详细说明

虽然该服务器使用开放的 MCP 标准，但它主要针对 Cline 用户进行设计和测试。

MCP Atlassian Server

Integrations