MCP Atlassian Sprint

MCP Atlassian是一个为Atlassian产品（Confluence和Jira）提供模型上下文协议服务的集成工具，支持云和本地部署。

知识管理与记忆开发者工具 #Atlassian集成 #知识管理 #项目管理 #IDE工具 .Python

评分 : 2.5分

下载量 : 22

更新时间 : 2025-04-28

什么是MCP Atlassian？

MCP Atlassian是一个模型上下文协议（MCP）服务器，用于连接和操作Atlassian平台中的Confluence和Jira服务。它允许您通过简单的命令访问和管理您的团队知识库和任务管理系统。

如何使用MCP Atlassian？

只需安装服务器并配置相应的API令牌即可开始使用。您可以搜索内容、创建页面、更新项目等。

适用场景

适用于需要高效管理和协作的企业团队，特别是那些依赖于Confluence和Jira进行知识共享和任务跟踪的团队。

主要功能

Confluence集成支持搜索、创建、更新和删除Confluence空间和页面。

Jira集成支持搜索、创建、更新和删除Jira项目及其相关任务。

多平台支持兼容Atlassian Cloud和Server/Data Center部署。

优势与局限性

优势

无缝集成Atlassian产品

支持多种查询语言（CQL和JQL）

易于安装和配置

局限性

需要有效的API令牌

某些高级功能可能需要特定权限

如何使用

安装服务器

通过brew、pip或Docker安装MCP Atlassian。

配置认证

生成API令牌并在服务器上配置URL和凭据。

开始使用

运行服务器并测试基本功能。

使用案例

案例1：搜索Confluence内容通过CQL查询搜索Confluence页面。

案例2：创建Jira任务通过JQL查询创建新的Jira任务。

常见问题

如何获取API令牌？

是否支持SSL验证？

如何切换传输模式？

相关资源

官方文档

详细的安装和配置指南。

GitHub代码仓库

源码和贡献指南。

演示视频

快速了解MCP Atlassian的功能。

安装

复制以下命令到你的Client进行配置

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://confluence.your-company.com",
        "--confluence-personal-token=your_token",
        "--jira-url=https://jira.your-company.com",
        "--jira-personal-token=your_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "python",
      "args": [
        "-m",
        "mcp-atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env-file",
        "/path/to/your/.env",
        "mcp/atlassian"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/your/mcp-atlassian",
        "run", "mcp-atlassian",
        "--confluence-url=https://your-domain.atlassian.net/wiki",
        "--confluence-username=your.email@domain.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-domain.atlassian.net",
        "--jira-username=your.email@domain.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

注意：您的密钥属于敏感信息，请勿与任何人分享。

🚀 MCP 阿特拉斯服务器指南

本指南将帮助你顺利配置并使用 MCP 阿特拉斯服务器来管理你的 Confluence 和 Jira 项目，涵盖安装、使用、开发调试等多方面内容。

🚀 快速开始

安装与配置

使用包管理器安装

你可以使用 npm 或 Yarn 来安装 mcp-atlassian：

npm install mcp-atlassian --save

或者使用 Yarn：

yarn add mcp-atlassian

创建配置文件

在项目的根目录下创建一个 .env 文件，并添加以下配置内容：

CONFLUENCE_URL=你的阿特拉斯网址
CONFLUENCE_USERNAME=你的用户名
CONFLUENCE_TOKEN=你的 API 令牌

JIRA_URL=你的 Jira 网址
JIRA_USERNAME=你的用户名
JIRA_TOKEN=你的 API 令牌

启动服务器

安装和配置完成后，使用以下命令启动服务器：

npx mcp-atlassian

✨ 主要特性

MCP 阿特拉斯服务器功能

过滤资源：仅显示用户活跃交互的阿特拉斯空间和 Jira 项目。
支持协议：
- confluence://{space_key}：访问 Confluence 空间
- jira://{project_key}：访问 Jira 项目

可用工具

工具	描述
`confluence_search`	使用 CQL 搜索 Confluence 内容
`confluence_get_page`	获取特定 Confluence 页面的内容
`confluence_get_page_children`	获取特定 Confluence 页面的子页面
`confluence_get_page_ancestors`	获取特定 Confluence 页面的父页面
`confluence_get_comments`	获取特定 Confluence 页面的评论
`confluence_create_page`	创建新的 Confluence 页面
`confluence_update_page`	更新现有的 Confluence 页面
`confluence_delete_page`	删除现有的 Confluence 页面
`jira_get_issue`	获取特定 Jira 问题的详细信息
`jira_search`	使用 JQL 搜索 Jira 问题
`jira_get_project_issues`	获取特定 Jira 项目的全部问题
`jira_create_issue`	在 Jira 中创建新的问题
`jira_update_issue`	更新现有的 Jira 问题
`jira_delete_issue`	删除现有的 Jira 问题
`jira_get_transitions`	获取特定 Jira 问题的可用状态转换
`jira_transition_issue`	将 Jira 问题过渡到新状态
`jira_add_worklog`	在 Jira 问题中添加工作日志
`jira_get_worklog`	获取 Jira 问题的工作日志条目
`jira_link_to_epic`	将问题链接到史诗任务
`jira_get_epic_issues`	获取与特定史诗任务相关联的所有问题

📦 安装指南

本地开发环境搭建

如果你需要进行开发和调试，可以按照以下步骤搭建本地开发环境：

克隆仓库：

git clone https://github.com/your-username/mcp-atlassian.git
cd mcp-atlassian

安装依赖项：
```
npm install
```
启动开发服务器：
```
npm run dev
```

调试工具

使用 mcp-debug 包来调试你的 MCP 服务器：

npm install mcp-debug --save-dev

💻 使用示例

基础用法

搜索 Confluence 内容

mcp-atlassian confluence_search --query "你的搜索词"

创建新 Jira 问题

mcp-atlassian jira_create_issue --projectKey "项目标识" --issueType "任务" --summary "问题摘要" --description "详细描述"

📚 详细文档

高级配置

设置代理服务器

在 .env 文件中添加以下内容以设置代理：

HTTP_PROXY=http://代理地址:端口
HTTPS_PROXY=https://代理地址:端口

启用日志记录

在 .env 文件中启用详细日志：

DEBUG=true

常见问题

如何处理认证失败？

检查你的用户名和令牌是否正确。
确保令牌具有足够的权限。

无法连接到阿特拉斯或 Jira？

检查网络连接。
确认目标 URL 正确无误。

如何调试工具命令？

使用 --verbose 选项在命令行中启用详细输出：
```
mcp-atlassian <command> --verbose
```

文档扩展

如需更多高级功能和配置选项，请参考完整的开发者文档： https://github.com/your-username/mcp-atlassian/wiki

🔧 技术细节

安全注意事项

保护令牌：不要在代码中明文存储 API 令牌，建议使用环境变量。
限制访问：确保阿特拉斯和 Jira 的访问权限符合安全策略。

通过以上指南，你可以顺利配置并使用 MCP 阿特拉斯服务器来管理你的 Confluence 和 Jira 项目。如果有任何问题或建议，请随时查阅文档或与社区联系。

精选MCP服务推荐

Duckduckgo MCP Server

已认证

DuckDuckGo搜索MCP服务器，为Claude等LLM提供网页搜索和内容抓取服务

Framelink Figma MCP Server是一个为AI编程工具（如Cursor）提供Figma设计数据访问的服务器，通过简化Figma API响应，帮助AI更准确地实现设计到代码的一键转换。

Firecrawl MCP Server是一个集成Firecrawl网页抓取能力的模型上下文协议服务器，提供丰富的网页抓取、搜索和内容提取功能。

百度地图MCP Server是国内首个兼容MCP协议的地图服务，提供地理编码、路线规划等10个标准化API接口，支持Python和Typescript快速接入，赋能智能体实现地图相关功能。

Exa MCP Server是一个为AI助手（如Claude）提供网络搜索功能的服务器，通过Exa AI搜索API实现实时、安全的网络信息获取。

TypeScript

2.0K

5分

Edgeone Pages MCP Server

EdgeOne Pages MCP是一个通过MCP协议快速部署HTML内容到EdgeOne Pages并获取公开URL的服务

MiniMax Model Context Protocol (MCP) 是一个官方服务器，支持与强大的文本转语音、视频/图像生成API交互，适用于多种客户端工具如Claude Desktop、Cursor等。

Context7 MCP是一个为AI编程助手提供实时、版本特定文档和代码示例的服务，通过Model Context Protocol直接集成到提示中，解决LLM使用过时信息的问题。

智启未来，您的人工智能解决方案智库