Personal JIRA MCP

Instructions

Implementation Reference

• src/jira_mcp/server.py:510-606 (handler)

  The primary MCP tool handler for 'get_attachment_by_filename'. It is decorated with @mcp.tool, defines the input parameters with type hints (serving as schema), and implements the full logic to retrieve, download, process (base64 encode if needed), and optionally save JIRA attachments by issue key and filename.

  @mcp.tool(
      description="根据问题ID和文件名获取JIRA附件",
  )
  def get_attachment_by_filename(
      issue_key: str,
      filename: str,
      save_to_disk: bool = True,
  ) -> Dict[str, Any]:
      """根据问题ID和文件名获取JIRA附件.
      
      Args:
          issue_key: JIRA问题键
          filename: 附件文件名
          save_to_disk: 是否保存到本地磁盘
      
      Returns:
          Dict[str, Any]: 附件内容
      """
      logger.info(f"根据文件名获取附件: issue={issue_key}, filename={filename}")
      try:
          # 使用JIRA REST API直接获取问题附件
          client = get_jira_client()
          
          # 获取问题详情
          issue_url = f"{jira_settings.server_url}/rest/api/2/issue/{issue_key}"
          response = client._session.get(issue_url)
          if response.status_code != 200:
              return {"error": f"获取问题失败: {response.text}"}
              
          issue_data = response.json()
          
          # 检查附件
          attachments = issue_data.get("fields", {}).get("attachment", [])
          if not attachments:
              return {"error": f"问题 {issue_key} 没有附件"}
              
          # 查找指定文件名的附件
          attachment = None
          for att in attachments:
              if att.get("filename") == filename:
                  attachment = att
                  break
                  
          if not attachment:
              return {"error": f"未找到名为 {filename} 的附件"}
              
          # 获取附件内容
          attachment_url = attachment.get("content")
          if not attachment_url:
              return {"error": "附件URL不存在"}
              
          # 下载附件
          response = client._session.get(attachment_url)
          if response.status_code != 200:
              return {"error": f"下载附件失败: {response.text}"}
              
          content = response.content
          mime_type = attachment.get("mimeType", "application/octet-stream")
          
          result = {
              "id": attachment.get("id"),
              "filename": filename,
              "size": len(content),
              "content_type": mime_type,
              "created": attachment.get("created"),
          }
          
          # 如果要保存到磁盘
          if save_to_disk:
              file_path = get_attachment_path(issue_key, filename)
              with open(file_path, "wb") as f:
                  f.write(content)
              result["local_path"] = file_path
          
          # 处理不同的内容类型
          if mime_type.startswith("image/"):
              # 对于图片，返回Base64编码
              result["content"] = base64.b64encode(content).decode('utf-8')
              result["encoding"] = "base64"
          elif mime_type.startswith("text/"):
              # 对于文本文件，直接返回文本内容
              try:
                  result["content"] = content.decode('utf-8')
                  result["encoding"] = "text"
              except UnicodeDecodeError:
                  # 如果解码失败，回退到Base64
                  result["content"] = base64.b64encode(content).decode('utf-8')
                  result["encoding"] = "base64"
          else:
              # 对于其他类型，返回Base64编码
              result["content"] = base64.b64encode(content).decode('utf-8')
              result["encoding"] = "base64"
          
          return result
      except Exception as e:
          logger.error(f"获取问题 {issue_key} 的附件 {filename} 失败: {str(e)}")
          return {"error": str(e)}