
MCP Atlassian

2025.03.06
3
TypeScriptAtlassian 集成协作工具交流协作
MCP Atlassian 是一个基于 Model Context Protocol (MCP) 的服务,旨在为 AI 代理提供与 Atlassian 产品(如 Confluence 和 Jira)交互的标准化接口。该服务通过一系列工具实现对 Confluence 和 Jira 的搜索、内容获取、项目管理等功能,适用于需要与 Atlassian 生态系统集成的自动化场景。
View on GitHub
Overview
基本能力
产品定位
MCP Atlassian 是一个中间件服务,专注于为 AI 代理提供与 Atlassian 产品(Confluence 和 Jira)交互的能力。
核心功能
- Confluence 交互:
- 搜索内容(使用 CQL)
- 获取空间信息
- 检索特定内容
-
列出空间中的所有页面
-
Jira 交互:
- 搜索问题(使用 JQL)
- 获取特定问题的详细信息
- 列出所有项目或特定项目
- 获取问题类型
适用场景
- 自动化文档检索和管理(Confluence)
- 自动化问题跟踪和项目管理(Jira)
- AI 代理与 Atlassian 生态系统的集成
工具列表
Confluence 工具
search-confluence
:使用 CQL 搜索 Confluence 内容get-confluence-space
:获取特定 Confluence 空间的信息get-confluence-content
:通过 ID 获取特定内容get-confluence-pages
:获取空间中所有页面
Jira 工具
search-jira-issues
:使用 JQL 搜索问题get-jira-issue
:通过键获取特定问题get-jira-projects
:获取所有项目get-jira-project
:通过键获取特定项目get-jira-issue-types
:获取所有问题类型
常见问题解答
- 需要 Atlassian 账户和 API 令牌
- 支持标准安装和 Docker 容器化部署
- 通过环境变量配置 Atlassian 凭证
使用教程
使用依赖
- Node.js (v16 或更高版本)
- npm 或 yarn
- Atlassian 账户和 API 令牌
- Docker(可选,用于容器化部署)
安装教程
标准安装
- 克隆仓库:
bash git clone https://github.com/yourusername/mcp-atlassian.git cd mcp-atlassian
- 安装依赖:
bash npm install # 或使用 make make install
- 创建
.env
文件并配置 Atlassian 凭证
Docker 安装
- 克隆仓库(同上)
- 创建
.env
文件(同上) - 构建并运行 Docker 容器: ```bash # 构建 Docker 镜像 make docker-build
# 运行 Docker 容器 make docker-run
# 或使用 Docker Compose make docker-compose ```
调试方式
- 启动服务器: ```bash # 使用 npm npm start
# 使用 make make start
# 使用 Docker make docker-run ``` 2. 测试工具功能 3. 检查日志输出