Personal JIRA MCP

Instructions

Implementation Reference

• src/jira_mcp/server.py:638-640 (registration)

  The @mcp.tool decorator that registers the download_all_attachments function as an MCP tool.

  @mcp.tool(
      description="下载JIRA问题的所有附件到本地",
  )

• src/jira_mcp/server.py:641-714 (handler)

  The core handler function implementing the logic to download all attachments for the specified JIRA issue key to a local directory, including error handling and result reporting.

  def download_all_attachments(
      issue_key: str,
  ) -> Dict[str, Any]:
      """下载JIRA问题的所有附件到本地.
      
      Args:
          issue_key: JIRA问题键
      
      Returns:
          Dict[str, Any]: 下载结果
      """
      logger.info(f"下载问题所有附件: {issue_key}")
      try:
          client = get_jira_client()
          issue = client.issue(issue_key)
          
          downloads = []
          failed = []
          
          # 获取附件列表
          attachments = []
          if hasattr(issue.fields, "attachment") and issue.fields.attachment:
              attachments = issue.fields.attachment
          
          if not attachments:
              return {
                  "issue_key": issue_key,
                  "message": "此问题没有附件",
                  "total": 0,
                  "downloads": []
              }
          
          # 为此问题创建目录
          issue_dir = os.path.join(ATTACHMENTS_DIR, issue_key)
          os.makedirs(issue_dir, exist_ok=True)
          
          # 下载每个附件
          for attachment in attachments:
              try:
                  file_path = os.path.join(issue_dir, attachment.filename)
                  
                  # 下载内容
                  content = attachment.get()
                  
                  # 保存到文件
                  with open(file_path, "wb") as f:
                      f.write(content)
                  
                  downloads.append({
                      "id": attachment.id,
                      "filename": attachment.filename,
                      "size": os.path.getsize(file_path),
                      "content_type": attachment.mimeType,
                      "local_path": file_path
                  })
              except Exception as e:
                  logger.error(f"下载附件 {attachment.filename} 失败: {str(e)}")
                  failed.append({
                      "filename": attachment.filename,
                      "error": str(e)
                  })
          
          return {
              "issue_key": issue_key,
              "total": len(attachments),
              "success": len(downloads),
              "failed": len(failed),
              "download_dir": issue_dir,
              "downloads": downloads,
              "failures": failed if failed else None
          }
      except Exception as e:
          logger.error(f"下载问题 {issue_key} 的所有附件失败: {str(e)}")
          return {"error": str(e)}