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
issues, projects, users]
Resources --> ConfRes[Confluence Resources
spaces, pages]
Tools --> JiraTools[Jira Tools
create, update, transition]
Tools --> ConfTools[Confluence Tools
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社区以获得更多支持。