AI导哈

Atlassian集成服务器

MCP Atlassian Server是一个连接AI代理与Atlassian Jira和Confluence的服务器，提供标准化的接口进行数据查询和操作。

  • by phuc-nt
  • TypeScript
  • 本地部署
  • 52 星标
  • 更新于
在 GitHub 查看 phuc-nt/mcp-atlassian-server

使用说明

MCP Atlassian服务器（由phuc nt提供）

2.1.1版本的新增功能🚀

  • 重构整个代码库以标准化资源/工具结构，完全删除内容元数据资源，并将元数据合并到页面资源中。
  • 新的开发人员指南：现在任何人都可以轻松地扩展和维护代码库。
  • 确保与最新MCP SDK的兼容性，提高安全性、可扩展性和可维护性。
  • 更新 docs/introduction/resources-and-tools.md 删除对内容元数据的所有引用。

👉 查看完整 更新日志 了解详情。

2.0.1版本的新增功能🎉

MCP Atlassian服务器v2.0.1 带来了功能和性能的重大扩展！

  • 更新的API：现在使用最新的Atlassian API（Jira API v3、Confluence API v2）
  • 扩展功能：功能从21个增加到48个，包括高级Jira和Confluence功能
  • 增强的董事会和Sprint管理：完整的敏捷/Scrum工作流支持
  • 高级汇流功能：页面版本管理、附件处理和评论管理
  • 改进了资源注册：修复了重复资源注册问题，以获得更稳定的体验
  • 文档更新：新的综合文档系列，解释MCP架构、资源/工具开发

有关所有更改、改进和修复的完整详细信息，请参阅 更新日志.

引言

MCP Atlassian服务器（由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的开发人员，我发现自己花了大量时间浏览这些工具。虽然它们很强大，但我渴望有一种更简单的方式与它们互动，而无需在深度工作中不断切换上下文。

人工智能代理和模型上下文协议（MCP）的出现提供了完美的机会。我立即看到了将Jira和Confluence（包括Slack、GitHub、Calendar等计划）连接到我的人工智能工作流程的潜力。

这个项目最初是对MCP和AI代理的学习之旅，但我希望它能发展成为对每天与Atlassian工具互动的个人和组织真正有用的东西。

系统架构

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服务器。

Cline用户须知：安装指南（llms-install.md）已针对Cline AI的理解和执行进行了优化。您可以简单地让Cline“安装MCP Atlassian服务器（由phuc nt）”，它将能够解析指令并帮助您逐步设置所有内容。

该指南包括：

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

通过Smithery安装

通过以下方式自动安装Atlassian Integration Server for Claude Desktop 史密瑟里:

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

功能概述

MCP Atlassian Server使AI助手（如Cline、Claude Desktop、Cursor……）能够使用全套功能访问和管理Jira&Confluence，为清晰起见进行分组：

Jira

  • 问题管理

    • 查看、搜索和筛选问题
    • 创建、更新、转换和分配问题
    • 将问题添加到积压或冲刺中，对问题进行排序

  • 项目管理

    • 查看项目列表、项目详细信息和项目角色

  • 董事会和Sprint管理

    • 查看板、板配置、问题和板上的冲刺
    • 创建、开始和结束冲刺

  • 过滤器管理

    • 查看、创建、更新和删除筛选器

  • 仪表板和小工具管理

    • 查看仪表板和小工具
    • 创建和更新仪表板
    • 在仪表板上添加或删除小工具

  • 用户管理

    • 按项目角色查看用户详细信息、可分配用户和用户

汇流

  • 空间管理

    • 查看空间列表、空间详细信息和空间中的页面

  • 页面管理

    • 查看、搜索和获取页面、子页面、祖先、附件和版本历史的详细信息
    • 创建、更新、重命名和删除页面

  • 评论管理

    • 查看、添加、更新和删除页面上的评论

有关所有功能、资源和工具的完整技术分解，请参阅： docs/introduce/resources-and-tools.md

请求流

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"

安全说明

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

贡献与支持

  • 在GitHub上打开Pull Requests或Issues进行贡献。
  • 加入MCP/Cline社区以获得更多支持。

相关 MCP