MCP Atlassian Fcr

MCP Atlassian是一个为Atlassian产品（Confluence和Jira）提供模型上下文协议服务的集成工具，支持云版和服务器/数据中心版部署，可实现内容搜索、页面管理、问题跟踪等功能。

知识管理与记忆开发者工具 #Atlassian集成 #团队协作 #项目管理 #知识管理

评分 : 2分

下载量 : 9.7K

更新时间 : 2025-04-23

打开站点

什么是MCP Atlassian?

MCP Atlassian 是一个集成模型上下文协议（MCP）的服务器，支持Confluence和Jira的云和本地部署。它可以帮助用户高效地管理和搜索企业知识库及任务。

如何使用MCP Atlassian?

通过配置服务器连接到Confluence和Jira后，您可以搜索、创建、更新和删除内容，以及管理任务和项目。

适用场景

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

主要功能

Confluence搜索

通过CQL查询搜索Confluence空间中的内容。

Jira任务管理

支持创建、更新、删除Jira任务，并管理任务状态和工作日志。

多传输模式

支持标准输入输出（stdio）和服务器发送事件（SSE）两种传输模式。

优势

支持Confluence和Jira的云和本地部署。

提供多种查询和操作工具，提高工作效率。

支持灵活的传输模式选择。

局限性

需要配置API密钥，可能涉及安全风险。

对大规模数据的处理速度可能较慢。

如何使用

安装MCP Atlassian

通过pip安装或使用Docker镜像启动服务器。

配置服务器

设置Confluence和Jira的URL、用户名和API密钥。

开始使用

通过MCP客户端连接服务器并执行查询。

使用案例

搜索Confluence文档

查找特定开发空间中的文档。

管理Jira任务

更新一个Jira任务的状态并添加备注。

常见问题

如何生成API密钥？

是否支持本地部署？

如何切换传输模式？

安装

复制以下命令到你的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": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://confluence.your-company.com",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_password"
      ]
    }
  }
}

{
  "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"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "mcp-atlassian",
      "args": [
        "--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-sse": {
      "url": "http://localhost:9000/sse"
    }
  }
}

{
  "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 协议（Claude）

MCP 协议（Claude）为与 Atlassian 的 Confluence 和 Jira 系统交互提供了便捷的方式，支持从 npm 包安装运行，也可从源码构建，还能利用 Docker 部署。同时提供了丰富的工具集，可对 Confluence 和 Jira 进行多方面操作。

🚀 快速开始

📦 安装指南

使用 npm 包

npm install @modelcontextprotocol/mcp-atlassian
npx @modelcontextprotocol/mcp-atlassian

从源码运行

git clone git@github.com:claude-mcp/mcp-atlassian.git
cd mcp-atlassian
npm install
node index.js

🔧 配置 MCP 服务器

使用包方式配置

在 ~/.cursor/mcp.json 中添加以下内容：

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "--directory",
        "/path/to/@modelcontextprotocol/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"
      ]
    }
  }
}

使用 Docker 运行

FROM node:16
WORKDIR /app
COPY package*.json ./
RUN npm install @modelcontextprotocol/mcp-atlassian
CMD ["npx", "@modelcontextprotocol/mcp-atlassian"]

🌐 资源访问

⚠️ 重要提示

MCP 服务器会根据用户当前交互的 Confluence 空间和 Jira 项目进行过滤，仅显示用户有权限操作的内容。

confluence://{space_key}: 访问特定的 Confluence 空间
jira://{project_key}: 访问特定的 Jira 项目

🛠️ 工具集

工具	描述
`confluence_search`	使用 CQL 搜索 Confluence 内容
`confluence_get_page`	获取特定 Confluence 页面的内容
`confluence_get_page_children`	获取特定页面的子页面
`confluence_get_page_ancestors`	获取特定页面的父页面
`confluence_get_comments`	获取特定页面上的评论
`confluence_create_page`	创建新的 Confluence 页面
`confluence_update_page`	更新现有 Confluence 页面
`confluence_delete_page`	删除现有 Confluence 页面
`confluence_attach_content`	将内容附件到 Confluence 页面上
`jira_get_issue`	获取特定 Jira 问题的详细信息
`jira_search`	使用 JQL 搜索 Jira 问题
`jira_get_project_issues`	获取特定项目的全部 Jira 问题
`jira_get_epic_issues`	获取与特定史诗相关联的所有 Jira 问题
`jira_create_issue`	在 Jira 中创建新的问题
`jira_update_issue`	更新现有的 Jira 问题
`jira_delete_issue`	删除现有的 Jira 问题
`jira_get_transitions`	获取特定问题的过渡选项
`jira_get_boards`	获取所有看板列表
`jira_get_board_columns`	获取特定看板的列信息
`jira_search_issues`	使用查询搜索 Jira 问题

💻 使用示例

基础用法

const { MCPClient } = require('@modelcontextprotocol/mcp');
const client = new MCPClient('mcp-atlassian');

client.confluence_search(query => {
  return {
    title: query.title,
    content: query.content,
    comments: query.comments
  };
});

🛠️ 开发与调试

配置 MCP 服务器（开发模式）

在 ~/.cursor/mcp.json 中添加以下内容：

{
  "mcpServers": {
    "development": {
      "command": "npm",
      "args": ["run", "dev"],
      "options": {
        "cwd": "/path/to/@modelcontextprotocol/mcp-atlassian"
      }
    }
  }
}