backlog-mcp 1.0.3__py3-none-any.whl → 1.0.5__py3-none-any.whl

app/main.py

@@ -11,6 +11,7 @@ app = FastMCP(
 # Add tool for Backlog MCP
 app.add_tool(get_issue_details)
 app.add_tool(get_user_issue_list)
+app.add_tool(update_issue_description)
 
 
 def main() -> int:

app/tools/__init__.py

@@ -1,2 +1,3 @@
 from .get_issue_details import *
 from .get_user_issue_list import *
+from .update_issue_description import *

app/tools/get_issue_details.py

@@ -4,13 +4,15 @@ from app.utils.ultils import get_issue_detail_handler
 
 async def get_issue_details(
     issue_key: str,
-    timezone: str = "UTC"
+    include_comments: bool,
+    timezone: str = "UTC",
 ):
     """
     Get details of a Backlog issue by its key.
 
     Args:
         issue_key (str): The key of the Backlog issue to retrieve.
+        include_comments (bool): Whether to include comments in the response.
         timezone (str, optional): The timezone to format datetime fields. Defaults to "UTC".
     """
     try:
@@ -22,6 +24,7 @@ async def get_issue_details(
             api_key=ctx.api_key,
             issue_key=issue_key,
             timezone=timezone,
+            include_comments=include_comments,
         )
         return result
     except Exception as e:

app/tools/update_issue_description.py

@@ -0,0 +1,31 @@
+from app.utils.di import create_backlog_context
+from app.utils.ultils import update_issue_description_handler
+
+
+async def update_issue_description(
+    issue_key: str,
+    description: str,
+):
+    """
+    Update the description of a Backlog issue.
+
+    Args:
+        issue_key (str): The key or ID of the Backlog issue to update.
+        description (str): The new description content for the issue.
+    """
+    try:
+        if not issue_key:
+            raise ValueError("Please provide an issue key.")
+        if not description:
+            raise ValueError("Please provide a description.")
+
+        ctx = create_backlog_context()
+        result = await update_issue_description_handler(
+            backlog_domain=ctx.backlog_domain,
+            api_key=ctx.api_key,
+            issue_key=issue_key,
+            description=description,
+        )
+        return result
+    except Exception as e:
+        raise e

app/utils/ultils.py

@@ -46,28 +46,29 @@ def time_in_range(time: str, start_range: str, end_range: str):
     return start_range_time <= time_to_be_compared <= end_range_time
 
 
-def process_issue_detail(issue_detail, timezone, issue_key):
+def process_issue_detail(issue_detail, timezone, issue_key, include_comments: bool = True):
     processed_issue = {
         "issue_key": issue_key,
         "summary": issue_detail["summary"],
         "description": issue_detail["description"]
     }
 
-    comments = issue_detail.get("comments", [])
-    if comments:
-        # Sort comments by created_at (created field)
-        sorted_comments = sorted(comments, key=lambda c: convert_to_timezone(timezone, c["created"]))
-        # Create list of {content, created_by} where created_by is just the name
-        processed_comments = [
-            {
-                "content": c["content"],
-                "created_by": c["createdUser"]["name"] if c.get("createdUser") else None
-            }
-            for c in sorted_comments if c.get("content")
-        ]
-        # Filter out None created_by if any (though should not happen)
-        processed_comments = [c for c in processed_comments if c["created_by"]]
-        processed_issue["comments"] = processed_comments
+    if include_comments:
+        comments = issue_detail.get("comments", [])
+        if comments:
+            # Sort comments by created_at (created field)
+            sorted_comments = sorted(comments, key=lambda c: convert_to_timezone(timezone, c["created"]))
+            # Create list of {content, created_by} where created_by is just the name
+            processed_comments = [
+                {
+                    "content": c["content"],
+                    "created_by": c["createdUser"]["name"] if c.get("createdUser") else None
+                }
+                for c in sorted_comments if c.get("content")
+            ]
+            # Filter out None created_by if any (though should not happen)
+            processed_comments = [c for c in processed_comments if c["created_by"]]
+            processed_issue["comments"] = processed_comments
 
     return processed_issue
 
@@ -77,6 +78,7 @@ async def get_issue_detail_handler(
         api_key: str,
         issue_key: str,
         timezone: str,
+        include_comments: bool = True,
 ):
     issue_comments_url = f"{backlog_domain}api/v2/issues/{issue_key}/comments"
     issue_detail_url = f"{backlog_domain}api/v2/issues/{issue_key}"
@@ -85,31 +87,38 @@ async def get_issue_detail_handler(
     async with httpx.AsyncClient() as client:
         try:
             issue_detail_response = client.get(issue_detail_url, params=params)
-            comments_response = client.get(issue_comments_url, params=params)
-
-            results = await asyncio.gather(issue_detail_response, comments_response)
-
-            issue_detail = results[0].json()
-            issue_comment = results[1].json()
+            
+            if include_comments:
+                comments_response = client.get(issue_comments_url, params=params)
+                results = await asyncio.gather(issue_detail_response, comments_response)
+                issue_detail_result = results[0]
+                comments_result = results[1]
+                issue_detail = issue_detail_result.json()
+                issue_comment = comments_result.json()
+            else:
+                issue_detail_result = await issue_detail_response
+                issue_detail = issue_detail_result.json()
+                issue_comment = []
 
-            if not results[0].is_success:
+            if not issue_detail_result.is_success:
                 error_code = issue_detail["errors"][0]["code"]
                 return {
                     "error_msg": BacklogApiError.get_description_by_code(error_code),
                 }
 
-            if not results[1].is_success:
+            if include_comments and not comments_result.is_success:
                 error_code = issue_comment["errors"][0]["code"]
                 return {
                     "error_msg": BacklogApiError.get_description_by_code(error_code),
                 }
 
-            comments_in_time_range = []
-            for comment in issue_comment:
-                comments_in_time_range.append(comment)
+            if include_comments:
+                comments_in_time_range = []
+                for comment in issue_comment:
+                    comments_in_time_range.append(comment)
+                issue_detail.update({"comments": comments_in_time_range})
 
-            issue_detail.update({"comments": comments_in_time_range})
-            processed_detail = process_issue_detail(issue_detail, timezone, issue_key)
+            processed_detail = process_issue_detail(issue_detail, timezone, issue_key, include_comments)
             return processed_detail
 
         except Exception as e:
@@ -291,3 +300,56 @@ async def get_current_user(backlog_domain: str, api_key: str) -> dict:
             raise ValueError(f"Failed to get current user: {e}") from e
         except Exception as e:
             raise ValueError(f"Unexpected error while getting current user: {e}") from e
+
+
+async def update_issue_description_handler(
+    backlog_domain: str,
+    api_key: str,
+    issue_key: str,
+    description: str,
+):
+    """Update issue description via Backlog API.
+
+    Args:
+        backlog_domain (str): Backlog domain URL
+        api_key (str): API key for authentication
+        issue_key (str): Issue key or ID
+        description (str): New description content
+
+    Returns:
+        dict: Updated issue information
+    """
+    try:
+        url = f"{backlog_domain}api/v2/issues/{issue_key}"
+        params = {"apiKey": api_key}
+        data = {"description": description}
+
+        async with httpx.AsyncClient() as client:
+            response = await client.patch(
+                url,
+                params=params,
+                data=data,
+                headers={"Content-Type": "application/x-www-form-urlencoded"},
+                timeout=10.0
+            )
+            response.raise_for_status()
+            result = response.json()
+
+            result = {
+                "issueKey": result["issueKey"],
+                "summary": result["summary"],
+                "description": result["description"]
+            }
+
+            return result
+    except httpx.HTTPStatusError as e:
+        try:
+            body = e.response.json()
+            error_code = None
+            if "errors" in body and body["errors"]:
+                error_code = body["errors"][0].get("code")
+            raise ValueError(f"API error: {BacklogApiError.get_description_by_code(error_code)}") from e
+        except Exception:
+            raise ValueError("Failed to parse error response") from e
+    except Exception as e:
+        raise ValueError(f"Request failed: {str(e)}") from e

{backlog_mcp-1.0.3.dist-info → backlog_mcp-1.0.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: backlog-mcp
-Version: 1.0.3
+Version: 1.0.5
 Summary: A Model Context Protocol (MCP) server for Backlog project management integration
 Author-email: BaoNguyen <baonguyen@teqnological.asia>
 Requires-Python: <3.14,>=3.13

{backlog_mcp-1.0.3.dist-info → backlog_mcp-1.0.5.dist-info}/RECORD

@@ -1,19 +1,20 @@
 app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 app/logging_config.py,sha256=1tSV1HXExfIi_mxOpugvGL7ywd43SMmsKsjARWXTLnU,999
-app/main.py,sha256=IZ-oDlynIZN-knCZqbUlnTMZ1YDJ-mHpUdAgv-Q-Lp4,488
+app/main.py,sha256=iCyuJoQlueVQjZWmAlmb1WuMBDO2arTHSjkjLoXCZqQ,527
 app/server_settings.py,sha256=mI-G1DKJ2IBg9dKuW4Da5MDhFLeYSQwLOGGNEb_kQwM,434
 app/constants/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 app/constants/constants.py,sha256=DV8HJnvCceHqUmA5csk9CcmcX9Zr0upl56qXVa9tF88,1664
 app/core/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 app/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 app/models/models.py,sha256=y3JhziNew3_2bM4Lw3aVjWcTvhmaEbzz0AaCHsdAkbk,4169
-app/tools/__init__.py,sha256=LxxyJiqccPQCNjei_YvtNJgEMs4U7IzKEsAaNKToaKg,68
-app/tools/get_issue_details.py,sha256=GMuC6lf33z0YTREq8VQ9oWwRe59XyHCnfpja0BMXjCw,819
+app/tools/__init__.py,sha256=v37to4C68ZJswTDeECaZZT3IPbRIe876CzJ_0XmZYCw,108
+app/tools/get_issue_details.py,sha256=efixu906oloeIZdf-geTlLxt9nLe-tPDqUlDd9HL6-g,973
 app/tools/get_user_issue_list.py,sha256=soNX0OfvfT1hIyzeDMPaHpAjHeGqavtZdTl0CemCpyo,865
+app/tools/update_issue_description.py,sha256=yS0yAETvDWeQYyeT-h7gTTihuszxyTJtizEyT6p4SX8,916
 app/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 app/utils/di.py,sha256=5MmL6efLAX3uzp5WSMi4E_BDCgapzlr_OERZoN5NGnM,408
-app/utils/ultils.py,sha256=LuTHKOZGhjU9LHGLNNzQJeck-UJYu49L4MK9ZfUoRtg,10798
-backlog_mcp-1.0.3.dist-info/METADATA,sha256=tLveO9390Py9GBN-YLzcvIEQYfW4EjR_8Cs5L45JaMA,3883
-backlog_mcp-1.0.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-backlog_mcp-1.0.3.dist-info/entry_points.txt,sha256=h5JeHYUp_uoaya4FO3QelcsgYOu-VRmh5qWRhPrwjtk,46
-backlog_mcp-1.0.3.dist-info/RECORD,,
+app/utils/ultils.py,sha256=_JGcpS-EMgp4gw_A3c4dTdPl5UEvVCM1x61n5VrQt70,13099
+backlog_mcp-1.0.5.dist-info/METADATA,sha256=t774bjIDzAc1nbJBF6ahSq3j7rb4oSFFstufxSdzAQg,3883
+backlog_mcp-1.0.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+backlog_mcp-1.0.5.dist-info/entry_points.txt,sha256=h5JeHYUp_uoaya4FO3QelcsgYOu-VRmh5qWRhPrwjtk,46
+backlog_mcp-1.0.5.dist-info/RECORD,,