Atlassian MCP (Markheramis)

Atlassian MCP服务器

一个模型上下文协议（MCP）服务器，提供与Atlassian JIRA和Confluence的无缝集成。此服务器使AI助手和其他MCP客户端能够通过标准化协议与您的Atlassian实例进行交互。

目录

• 概述
• 特性
• 先决条件
• 安装

- - 手动安装

• 配置

- 配置文件 - 环境变量

• 用法

- 与克莱恩 - 带光标 - 使用克劳德桌面

• 可用工具

- JIRA工具 - 汇流工具

• MCP资源
• 发展
• 调试
• 故障排除
• 许可证

概述

Atlassian MCP服务器实现了 模型上下文协议 规范，允许AI助手：

• 管理JIRA工单（创建、更新、转换、评论等）
• 使用Confluence页面（创建、更新、搜索等）
• 访问项目元数据和配置
• 使用工作日志跟踪时间
• 管理标签、观察者和附件

特性

JIRA集成

汇流集成

先决条件

在安装Atlassian MCP服务器之前，请确保您已经：

1. Node.js （版本18或更高）
2. npm 或 纱线 包管理器
3. Atlassian云帐户 具有API访问权限
4. Atlassian API代币 -生成一个 Atlassian帐户设置

安装

NPM安装

全局安装软件包：

npm install -g atlassian-mcp-server

安装后，运行安装向导：

atlassian-mcp-setup

手动安装

1. 克隆存储库：

git clone https://github.com/kompallik/ATLASSIAN-MCP.git
cd ATLASSIAN-MCP

1. 安装依赖项：

npm install

1. 构建项目：

npm run build

1. 运行安装向导：

npm run setup

配置

服务器可以使用配置文件或环境变量进行配置。

配置文件

创建一个 config/config.json 文件（或运行 npm run setup 以交互方式创建一个）：

{
  "atlassian": {
    "baseUrl": "https://your-instance.atlassian.net",
    "email": "your-email@example.com",
    "token": "your-api-token-here"
  },
  "server": {
    "name": "atlassian-server",
    "version": "0.1.0"
  }
}

环境变量

或者，使用环境变量配置服务器：

用法

与克莱恩

将以下内容添加到Cline MCP设置中：

{
  "mcpServers": {
    "atlassian-server": {
      "command": "atlassian-mcp-server",
      "args": [],
      "env": {
        "ATLASSIAN_CONFIG_PATH": "/path/to/config/config.json"
      },
      "disabled": false
    }
  }
}

带光标

添加到光标设置(~/.cursor/mcp.json):

{
  "mcpServers": {
    "atlassian-server": {
      "command": "node",
      "args": ["/path/to/mcp-atlassian/build/index.js"],
      "env": {
        "ATLASSIAN_BASE_URL": "https://your-instance.atlassian.net",
        "ATLASSIAN_EMAIL": "your-email@example.com",
        "ATLASSIAN_TOKEN": "your-api-token",
        "SERVER_NAME": "my.atlassian-server",
        "SERVER_VERSION": "0.1.0"
      },
      "disabled": false
    }
  }
}

或者，如果通过NPM全局安装：

{
  "mcpServers": {
    "atlassian-server": {
      "command": "atlassian-mcp-server",
      "args": [],
      "env": {
        "ATLASSIAN_CONFIG_PATH": "/path/to/config/config.json"
      },
      "disabled": false
    }
  }
}

使用克劳德桌面

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "atlassian-server": {
      "command": "atlassian-mcp-server",
      "env": {
        "ATLASSIAN_BASE_URL": "https://your-instance.atlassian.net",
        "ATLASSIAN_EMAIL": "your-email@example.com",
        "ATLASSIAN_TOKEN": "your-api-token"
      }
    }
  }
}

可用工具

JIRA工具

票务操作

评论

工作日志（时间跟踪）

标签和观察者

附件

项目信息

汇流工具

页面操作

搜索

评论

标签

附件

导航和层次结构

空间

MCP资源

服务器将Atlassian内容作为MCP资源公开：

资源会自动列出最近的JIRA票证（在过去30天内更新）。

发展

项目结构

mcp-atlassian/
├── src/
│   ├── index.ts              # Server entry point
│   ├── config.ts             # Configuration management
│   ├── api-client.ts         # Axios client setup
│   ├── types/
│   │   └── tools.ts          # TypeScript type definitions
│   ├── handlers/
│   │   ├── resources.ts      # MCP resource handlers
│   │   ├── tools.ts          # Tool definitions
│   │   └── tool-executor.ts  # Tool execution router
│   ├── jira/
│   │   ├── index.ts          # JIRA tool registry
│   │   └── tools/            # Individual JIRA tool implementations
│   ├── confluence/
│   │   ├── index.ts          # Confluence tool registry
│   │   └── tools/            # Individual Confluence tool implementations
│   └── utils/
│       ├── adf.ts            # Atlassian Document Format utilities
│       ├── cache.ts          # Caching utilities
│       ├── cql.ts            # Confluence Query Language utilities
│       ├── jql-validator.ts  # JQL validation
│       ├── response.ts       # Response formatting
│       ├── user-lookup.ts    # User lookup utilities
│       └── validation.ts     # Input validation
├── build/                    # Compiled JavaScript output
├── config/
│   └── config.sample.json    # Sample configuration file
├── package.json
├── tsconfig.json
└── README.md

建筑

# Build the project
npm run build

# Run in development mode
npm run dev

# Start the built server
npm start

添加新工具

1. 在中创建新文件 src/jira/tools/ 或 src/confluence/tools/
2. 导出一个接受的处理函数 (args, apiClient)
3. 在相应的索引文件中注册该工具(src/jira/index.ts 或 src/confluence/index.ts)
4. 在中添加工具定义 src/handlers/tools.ts

调试

启用调试模式以查看详细的API请求和响应：

MCP_DEBUG=true atlassian-mcp-server

或者在MCP客户端配置中设置：

{
  "mcpServers": {
    "atlassian-server": {
      "command": "atlassian-mcp-server",
      "env": {
        "MCP_DEBUG": "true",
        "ATLASSIAN_CONFIG_PATH": "/path/to/config.json"
      }
    }
  }
}

故障排除

常见问题

获取API令牌

1. 首选 Atlassian帐户设置
2. 点击“创建API令牌”
3. 给它一个描述性的标签
4. 立即复制令牌（不会再次显示）

需要权限

要获得完整功能，您的Atlassian帐户需要：

• JIRA：浏览项目、创建问题、编辑问题、管理观察者、添加评论
• 汇流：查看空间、添加页面、添加评论、添加附件

许可证

MIT许可证-请参阅 许可证 了解详情。

作者

科迪尼亚 Kompalli -

贡献

欢迎投稿！请随时提交拉取请求。

1. 克隆该仓库
2. 创建功能分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add some amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求