get_issue_attachments
Retrieve all attachments from a JIRA issue to access supporting files and documents. Specify the issue key to fetch attachments, with an option to download them directly.
Instructions
获取JIRA问题的所有附件
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"issue_key": "<issue_key>"
},
"name": "get_issue_attachments"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| issue_key | Yes | ||
| download | No |
Implementation Reference
- src/jira_mcp/server.py:717-769 (handler)The main handler and registration for the get_issue_attachments MCP tool. Lists all attachments for a JIRA issue, checks local existence, and optionally downloads via download_all_attachments.
@mcp.tool( description="获取JIRA问题的所有附件", ) def get_issue_attachments( issue_key: str, download: bool = False ) -> Dict[str, Any]: """获取JIRA问题的所有附件信息. Args: issue_key: JIRA问题键 download: 是否下载附件到本地 Returns: Dict[str, Any]: 附件列表 """ logger.info(f"获取问题附件列表: {issue_key}, download={download}") if download: return download_all_attachments(issue_key) try: client = get_jira_client() issue = client.issue(issue_key) attachments = [] if hasattr(issue.fields, "attachment") and issue.fields.attachment: for attachment in issue.fields.attachment: # 检查附件是否已存在于本地 local_path = get_attachment_path(issue_key, attachment.filename) exists_locally = os.path.exists(local_path) attachments.append({ "id": attachment.id, "filename": attachment.filename, "size": attachment.size, "content_type": attachment.mimeType, "created": str(attachment.created), # 确保日期是字符串 "url": str(attachment.content), # 确保URL是字符串 "local_path": local_path if exists_locally else None, "exists_locally": exists_locally }) return { "issue_key": issue_key, "attachments": attachments, "total": len(attachments), "attachments_dir": os.path.join(ATTACHMENTS_DIR, issue_key) } except Exception as e: logger.error(f"获取问题 {issue_key} 附件列表失败: {str(e)}") return {"error": str(e)} - src/jira_mcp/server.py:31-37 (helper)Helper utility to determine the local filesystem path for storing attachments of a specific JIRA issue.
def get_attachment_path(issue_key: str, filename: str) -> str: """获取附件在本地文件系统中的保存路径.""" # 创建问题专属目录 issue_dir = os.path.join(ATTACHMENTS_DIR, issue_key) os.makedirs(issue_dir, exist_ok=True) return os.path.join(issue_dir, filename) - src/jira_mcp/server.py:638-715 (helper)Supporting tool/helper invoked by get_issue_attachments when download parameter is True. Downloads all attachments to local directory and returns download results.
@mcp.tool( description="下载JIRA问题的所有附件到本地", ) 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)}