使用说明

项目简介

本仓库为Atlassian Jira, Confluence, 和 Bitbucket Data Center 产品提供了 Model Context Protocol (MCP) 服务器的实现。它允许AI助手通过标准化的MCP协议，安全地访问和操作您的Atlassian Data Center 实例中的数据和功能。

主要功能点

Jira 集成: 提供搜索、查看和创建 Jira Issue 的工具。
Confluence 集成: 提供访问和管理 Confluence 内容的工具。
Bitbucket 集成: 提供与 Bitbucket 仓库和代码交互的工具。
标准化接口: 基于 MCP 协议，提供与各种 LLM 客户端兼容的标准化接口。
易于配置: 通过简单的 JSON 配置文件即可将 MCP 服务器连接到 Claude Desktop 等 MCP 客户端。

安装步骤

克隆仓库

git clone https://github.com/b1ff/atlassian-dc-mcp.git
cd atlassian-dc-mcp

安装依赖
```
npm install
```

服务器配置

要将此 MCP 服务器集成到 MCP 客户端（例如 Claude Desktop），您需要配置客户端以启动并连接到此服务器。以下是 Claude Desktop 的配置示例，您需要将其添加到 Claude Desktop 的配置文件 'claude_desktop_config.json' 中。请根据您需要集成的 Atlassian 产品选择相应的配置，并替换占位符为您实际的 Jira, Confluence, 和 Bitbucket 实例的域名和 API Token。

{
  "mcpServers": {
    "atlassian-jira-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/jira"],
      "env": {
        "JIRA_HOST": "your-jira-host",
        "JIRA_API_TOKEN": "your-token"
      }
    },
    "atlassian-confluence-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/confluence"],
      "env": {
        "CONFLUENCE_HOST": "your-confluence-host",
        "CONFLUENCE_API_TOKEN": "your-token"
      }
    },
    "atlassian-bitbucket-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/bitbucket"],
      "env": {
        "BITBUCKET_HOST": "your-bitbucket-host",
        "BITBUCKET_API_TOKEN": "your-token"
      }
    }
  }
}

配置参数说明:

'server name' (服务器名称): 例如 'atlassian-jira-dc'，用于在 Claude Desktop 配置文件中标识和引用该服务器。
'command' (启动命令): 'npx'，用于执行 Node.js 包。
'args' (命令参数): 例如 '["-y", "@atlassian-dc-mcp/jira"]'，指定要执行的 npm 包，'-y' 参数用于跳过 'npm install' 的确认提示。'@atlassian-dc-mcp/jira', '@atlassian-dc-mcp/confluence', '@atlassian-dc-mcp/bitbucket' 分别对应 Jira, Confluence, Bitbucket 的 MCP 服务器实现。
'env' (环境变量):
- 'JIRA_HOST', 'CONFLUENCE_HOST', 'BITBUCKET_HOST': 您的 Atlassian 产品 Data Center 实例的域名和端口 (例如 'your-instance.atlassian.net'，不包含 'https://' 协议头)。
- 'JIRA_API_TOKEN', 'CONFLUENCE_API_TOKEN', 'BITBUCKET_API_TOKEN': 您在 Atlassian 产品中生成的 Personal Access Token (PAT)，用于 API 访问认证。

基本使用方法

启动 MCP 服务器: 根据您要使用的 Atlassian 产品，运行相应的开发命令，例如启动 Jira MCP 服务器：
```
npm run dev:jira
```
或者，您可以使用 'npx' 直接运行包：
```
npx -y @atlassian-dc-mcp/jira
```
配置 MCP 客户端: 将上面生成的 JSON 配置添加到您的 MCP 客户端 (例如 Claude Desktop) 的配置文件中，并确保替换占位符为您实际的 Atlassian 实例信息和 API Token。
在 MCP 客户端中使用工具: 配置完成后，在您的 MCP 客户端中，您应该能够看到注册的工具 (例如 Jira 的 'jira_searchIssues', 'jira_getIssue' 等)。您可以调用这些工具，让 AI 助手与您的 Atlassian Data Center 实例进行交互。

注意: 首次使用前，请务必先在 Atlassian Data Center 实例中生成 Personal Access Token (PAT)，并替换配置文件中的 'your-api-token' 占位符。

关键词