Atlassian集成服务器

一个提供与Atlassian Jira和Confluence全面集成的模型上下文协议服务器,允许LLMs搜索、查看和修改问题和页面。

  • by Ayush4087
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Ayush4087/Atlassian-MCP-Server

使用说明

Atlassian MCP服务器

一个模型上下文协议(MCP)服务器,提供与Atlassian Jira和Confluence的全面集成。此服务器允许LLM与您的Atlassian套件交互,以搜索、查看和修改问题和页面。

特性

Jira工具

  • 搜索:使用JQL查找问题(searchJiraIssuesUsingJql).
  • 问题管理:
    • 获取问题详细信息(getJiraIssue).
    • 创建(createJiraIssue)并编辑(editJiraIssue)问题。
    • 查看远程链接(getJiraIssueRemoteIssueLinks).
  • 评论和工作日志:添加评论(addCommentToJiraIssue)以及工作日志(addWorklogToJiraIssue).
  • 元数据:检查问题类型(getJiraProjectIssueTypesMetadata, getJiraIssueTypeMetaWithFields).
  • 过渡:查看(getTransitionsForJiraIssue)并执行(transitionJiraIssue)工作流转换。
  • 项目和用户:列出可见项目(getVisibleJiraProjects)并查找帐户ID(lookupJiraAccountId).

汇流工具

  • 搜索:使用CQL查找页面(searchConfluenceUsingCql).
  • 页面管理:
    • 获取页面内容(getConfluencePage).
    • 创建(createConfluencePage)并更新(updateConfluencePage)页面。
    • 列出后代(getConfluencePageDescendants)空间中的页面(getPagesInConfluenceSpace).
  • 评论:
    • 添加页脚(createConfluenceFooterComment)和内联(createConfluenceInlineComment)评论。
    • 阅读评论(getConfluencePageFooterComments, getConfluencePageInlineComments).
  • 空间:列出可用空间(getConfluenceSpaces).

先决条件

  • Python 3.10或更高版本
  • Atlassian帐户(Jira/Confluence Cloud)
  • 大西洋API代币

安装

  1. 克隆存储库:

    git clone <repository_url>
    cd Atlassian-MCP-Server
    
  2. 创建并激活虚拟环境:

    python3 -m venv .venv
    source .venv/bin/activate  # On Windows use .venv\Scripts\activate
    
  3. 安装依赖项:

    pip install -r requirements.txt
    

配置

  1. 创建一个 .env 根目录中的文件:

    touch .env
    
  2. 将您的Atlassian凭据添加到 .env:

    ATLASSIAN_EMAIL=your_email@example.com
    ATLASSIAN_API_TOKEN=your_api_token
    ATLASSIAN_BASE_URL=https://your-domain.atlassian.net
    

    备注:您可以从您的 Atlassian帐户设置.

用法

本地运行

要专门运行服务器(尽管通常通过MCP客户端使用):

python server.py

与Claude Desktop一起使用

要将此服务器与Claude Desktop一起使用,请将以下配置添加到您的 claude_desktop_config.json (通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):

{
  "mcpServers": {
    "atlassian": {
      "command": "/path/to/Atlassian-MCP-Server/.venv/bin/python",
      "args": [
        "/path/to/Atlassian-MCP-Server/server.py"
      ]
    }
  }
}

替换 /path/to/Atlassian-MCP-Server 带有克隆存储库的绝对路径。

贡献

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