Skip to main content
Glama
phuc-nt
by phuc-nt

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

MCP Atlassian 服务器 (由 phuc-nt 提供) 铁匠徽章

2.1.1 版新增功能

  • 重构整个代码库以标准化资源/工具结构,完全删除内容元数据资源,并将元数据合并到页面资源中。

  • 新的开发者指南:现在任何人都可以轻松扩展和维护代码库。

  • 确保与最新的MCP SDK兼容,提高安全性、可扩展性和可维护性。

  • 更新了docs/introduction/resources-and-tools.md以删除所有对内容元数据的引用。

👉请参阅完整的

Related MCP server: Atlassian Confluence MCP Server

2.0.1 版新增功能🎉

MCP Atlassian Server v2.0.1带来了功能和能力的重大扩展!

  • 更新的 API :现在使用最新的 Atlassian API(Jira API v3、Confluence API v2)

  • 扩展功能:功能从 21 个增加到 48 个,包括高级 Jira 和 Confluence 功能

  • 增强的 Board & Sprint 管理:完整的 Agile/Scrum 工作流程支持

  • 高级 Confluence 功能:页面版本管理、附件处理和评论管理

  • 改进资源注册:修复重复资源注册问题,以获得更稳定的体验

  • 文档更新:全新综合文档系列,解释 MCP 架构、资源/工具开发

有关所有更改、改进和修复的完整详细信息,请参阅CHANGELOG

介绍

**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 工具交互的个人和组织真正有用的东西。

系统架构

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 的理解和执行进行了优化。您只需输入“安装 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

功能概述

MCP Atlassian Server 使 AI 助手(如 Cline、Claude Desktop、Cursor……)能够访问和管理 Jira 和 Confluence,并提供全套功能,这些功能按清晰的方式分组:

吉拉

  • 问题管理

    • 查看、搜索和过滤问题

    • 创建、更新、转换和分配问题

    • 将问题添加到待办事项或冲刺中,对问题进行排序

  • 项目管理

    • 查看项目列表、项目详情、项目角色

  • 董事会与冲刺管理

    • 查看看板、看板配置、看板上的问题和冲刺

    • 创建、启动和结束冲刺

  • 过滤管理

    • 查看、创建、更新和删除过滤器

  • 仪表板和小工具管理

    • 查看仪表板和小工具

    • 创建和更新仪表板

    • 在仪表板上添加或删除小工具

  • 用户管理

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

合流

  • 空间管理

    • 查看空间列表、空间详情、空间内的页面

  • 页面管理

    • 查看、搜索并获取页面、子页面、祖先、附件和版本历史记录的详细信息

    • 创建、更新、重命名和删除页面

  • 评论管理

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

有关所有功能、资源和工具的完整技术细节,请参阅: docs/introduction/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 请求或问题来做出贡献。

  • 加入 MCP/Cline 社区以获得更多支持。

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/phuc-nt/mcp-atlassian-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server