MCP Atlassian 服务器

MCP 服务器用于集成 Atlassian 产品（Confluence、Jira）与 Model Context Protocol。该工具允许您通过 MCP 界面轻松访问 Confluence 内容和 Jira 工单。

功能

Confluence

• 使用 CQL（Confluence 查询语言）搜索内容
• 访问页面、附件和评论
• 按空间（space）过滤

Jira

• 使用 JQL（Jira 查询语言）搜索问题
• 获取问题详情，包括状态、分配和时间戳

安装

通过 Smithery 安装

通过 Smithery 自动安装 Atlassian 集成服务器：

npx -y @smithery/cli install @petrsovadina/mcp-atlassian --client claude

手动安装

git clone https://github.com/petrsovadina/mcp-atlassian.git
cd mcp-atlassian
npm install
npm run build

配置

设置以下环境变量：

Confluence

CONFLUENCE_URL=https://your-domain.atlassian.net/wiki
CONFLUENCE_USERNAME=your-email@domain.com
CONFLUENCE_API_TOKEN=your-api-token

Jira

JIRA_URL=https://your-domain.atlassian.net
JIRA_USERNAME=your-email@domain.com
JIRA_API_TOKEN=your-api-token

在 MCP 中使用

将以下配置添加到您的 MCP 设置文件中：

{
  "mcpServers": {
    "atlassian": {
      "command": "node",
      "args": ["/path/to/mcp-atlassian/build/index.js"],
      "env": {
        "CONFLUENCE_URL": "your-confluence-url",
        "CONFLUENCE_USERNAME": "your-username",
        "CONFLUENCE_API_TOKEN": "your-api-token",
        "JIRA_URL": "your-jira-url",
        "JIRA_USERNAME": "your-username",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

可用工具

confluence_search

使用 CQL 在 Confluence 内容中搜索。

{
  "query": "type=page AND space='Engineering'", // CQL 查询
  "limit": 10 // 可选结果限制（1-50）
}

jira_search

使用 JQL 在 Jira 问题中搜索。

{
  "jql": "project = ENG AND status = Open", // JQL 查询
  "fields": "summary,status,assignee", // 可选字段
  "limit": 10 // 可选结果限制（1-50）
}

资源模板

Confluence 页面

confluence://{space_key}/pages/{title}

Jira 问题

jira://{project_key}/issues/{issue_key}

使用示例

在 Confluence 中搜索

const result = await mcp.use('confluence_search', {
  query: "type=page AND space='Engineering' ORDER BY created DESC",
  limit: 5
});

在 Jira 中搜索

const result = await mcp.use('jira_search', {
  jql: "project = ENG AND status = 'In Progress'",
  fields: "summary,status,assignee,created",
  limit: 5
});

贡献

如果您想为开发做出贡献，您可以：

1. Fork 仓库
2. 创建功能分支
3. 提交您的更改
4. 推送分支
5. 创建 Pull Request

许可证

MIT