MCP Atlassian Server (by phuc-nt)

简介

MCP Atlassian Server (by 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工具互动的个人和组织真正有用的东西。

系统架构

mermaid
graph TD
AI[Cline AI Assistant] <--> MCP[MCP Atlassian Server]
MCP <--> JiraAPI[Jira API]
MCP <--> ConfAPI[Confluence API]

subgraph "MCP Server"
    Resources[Resources - Read Only] 
    Tools[Tools - Actions]
end

Resources --> JiraRes[Jira Resources<br/>issues, projects, users]
Resources --> ConfRes[Confluence Resources<br/>spaces, pages]
Tools --> JiraTools[Jira Tools<br/>create, update, transition]
Tools --> ConfTools[Confluence Tools<br/>create page, comment]

安装与设置

有关详细的安装和设置说明，请参阅我们的AI助手安装指南。此指南特别为像Cline这样的AI/LLM助手阅读和自动设置MCP Atlassian Server进行了格式化。

Cline用户注意事项：安装指南（llms-install.md）针对Cline AI进行了优化，以便理解和执行。您只需让Cline“安装MCP Atlassian Server (by phuc-nt)”即可解析说明并逐步帮助您完成所有设置。

指南包括：

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

通过Smithery安装

要通过Smithery自动为Claude Desktop安装Atlassian集成服务器：

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

功能概述

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

| 类型 | 组 | 功能 | 描述 | 状态 || 资源 | Jira | 查看问题、项目、用户、评论、角色 | 查询 Jira 数据（JQL、详细信息、列表） | ✔ |
| 资源 | Jira | 过滤器、看板、仪表盘、冲刺 | 开发者的高级管理 | 🚧 |
| 资源 | Confluence | 查看空间、页面、子页面、评论 | 查询 Confluence 数据 | ✔ |
| 资源 | Confluence | 标签、附件、内容版本 | 高级文档管理 | 🚧 |
| 资源 | 其他 | 智能缓存、高级 JQL/CQL、模板 | 性能、体验、UI 集成 | 🚧 |
| 工具 | Jira | 创建、更新、转换问题 | 直接对 Jira 进行操作 | ✔ |
| 工具 | Confluence | 创建页面、更新页面（标题、内容、版本、标签）、管理标签、添加评论 | 直接对 Confluence 进行操作（创建、更新、添加/移除标签、评论） | ✔ |
| 工具 | 其他 | 提示、采样、个性化 | AI 优化、个性化、高级流程 | 🚧 |

请求流程

mermaid
sequenceDiagram
participant User
participant Cline as Cline AI
participant MCP as MCP Server
participant Atlassian as Atlassian API

User->>Cline: "Find all my assigned issues"
Cline->>MCP: Request jira://issues
MCP->>Atlassian: API Request with Auth
Atlassian->>MCP: JSON Response
MCP->>Cline: Formatted MCP Resource
Cline->>User: "I found these issues..."

User->>Cline: "Create new issue about login bug"
Cline->>MCP: Call createIssue Tool
MCP->>Atlassian: POST /rest/api/3/issue
Atlassian->>MCP: Created Issue Data
MCP->>Cline: Success Response
Cline->>User: "Created issue DEMO-123"

示例用例

安装后尝试向 Cline 提出以下查询：

1. 创建和管理任务

   • "在项目 DEMO 中创建关于登录错误的新问题"
   • "查找当前冲刺中分配给我的所有问题"
   • "将问题 DEMO-43 转换为完成状态"

2. 项目信息摘要

   • "汇总项目 DEMO 中的所有问题"
   • "谁被分配了项目 DEMO 中的问题？"
   • "列出当前冲刺中的未分配问题"

3. 使用 Confluence 的文档

   • "创建一个名为 'Meeting Notes' 的 Confluence 页面"
   • "使用新示例和标签更新 'API Documentation' Confluence 页面"
   • "为关于架构的页面添加 'documentation' 标签"
   • "从 'Meeting Notes' 页面移除 'draft' 标签"
   • "为关于 API 文档的 Confluence 页面添加评论"

4. 分析和报告

   • "比较当前冲刺和上一个冲刺之间完成的问题数量"
   • "谁在 'To Do' 状态下拥有最多的问题？"

这些查询在 Cline 环境中效果最佳，该环境已与本 MCP 服务器进行了彻底测试。

使用说明

1. 简单的 JQL：在搜索问题时，请使用没有空格或特殊字符的简单 JQL（例如，project=DEMO 而不是 project = DEMO AND key = DEMO-43）。

2. 创建 Confluence 页面：在创建 Confluence 页面时，请使用简单的 HTML 内容，并且不要指定 parentId 以避免错误。

3. 更新 Confluence 页面：在更新页面时，始终包含当前版本号以避免冲突。您还可以更新标签（添加/移除），并且必须使用有效的存储格式进行内容更新。

4. 创建问题：在创建新问题时，仅提供最少必需的字段（projectKey, summary）以获得最佳成功。

5. 访问权限：确保配置的 Atlassian 帐户具有访问您要与其交互的项目和空间的权限。

安全注意事项

• 您的 API 令牌继承了创建它的用户的全部权限。- 永远不要将您的令牌分享给不可信的第三方
• 在要求大型语言模型（LLM）分析包含您令牌的配置文件时要小心
• 请参阅 llms-install.md 中的安全指南

贡献与支持

• 通过在 GitHub 上提交 Pull Requests 或 Issues 来贡献。
• 加入 MCP/Cline 社区以获得更多支持。

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

尽管服务器使用开放的 MCP 标准，但它主要是为 Cline 用户设计和测试的。