MCP Atlassian

MCP Atlassian

模型上下文协议 (MCP) 服务器提供与 Atlassian 产品（Confluence 和 Jira）交互的工具。

概述

该 MCP 服务器允许 AI 代理通过标准化接口与 Atlassian 产品进行交互。它提供以下工具：

• Confluence ：搜索内容、获取空间、检索内容和列出页面
• Jira ：搜索问题、获取问题详细信息、列出项目等

先决条件

• Node.js（v16 或更高版本）
• npm 或 yarn
• 带有 API 令牌的 Atlassian 帐户
• Docker（可选，用于容器化部署）

安装

标准安装

1. 克隆存储库：
   git clone https://github.com/yourusername/mcp-atlassian.git cd mcp-atlassian
2. 安装依赖项：
   npm install # or using make make install
3. 使用您的 Atlassian 凭据在根目录中创建一个.env文件：
   ATLASSIAN_HOST=https://your-domain.atlassian.net ATLASSIAN_EMAIL=your-email@example.com ATLASSIAN_API_TOKEN=your-api-token

Docker 安装

1. 克隆存储库：
   git clone https://github.com/yourusername/mcp-atlassian.git cd mcp-atlassian
2. 按照上述说明创建一个.env文件。
3. 构建并运行 Docker 容器：
   # Build the Docker image make docker-build # Run the Docker container make docker-run # Or use Docker Compose make docker-compose

用法

启动服务器

这将启动 MCP 服务器，它将监听 stdin 上的请求并在 stdout 上做出响应。

可用工具

Confluence 工具

• search-confluence ：使用 CQL 在 Confluence 中搜索内容
  • 参数： query （字符串）
• get-confluence-space ：获取有关特定 Confluence 空间的信息
  • 参数： spaceKey （字符串）
• get-confluence-content ：通过 ID 获取特定内容
  • 参数： contentId （字符串）
• get-confluence-pages ：获取空间中的所有页面
  • 参数： spaceKey （字符串）、 limit （数字，可选）

Jira 工具

• search-jira-issues ：使用 JQL 搜索问题
  • 参数： jql （字符串）、 maxResults （数字，可选）
• get-jira-issue ：通过键获取特定问题
  • 参数： issueKey （字符串）
• get-jira-projects ：获取所有项目
  • 参数：无
• get-jira-project ：通过键获取特定项目
  • 参数： projectKey （字符串）
• get-jira-issue-types ：获取所有问题类型
  • 参数：无

发展

项目结构

建筑

测试

Makefile 命令

该项目包含一个 Makefile 来简化常见操作：

执照

麻省理工学院

贡献

1. 分叉存储库
2. 创建你的功能分支（ git checkout -b feature/amazing-feature ）
3. 提交您的更改（ git commit -m 'Add some amazing feature' ）
4. 推送到分支（ git push origin feature/amazing-feature ）
5. 打开拉取请求