backlog-mcp 1.0.2__py3-none-any.whl → 1.0.4__py3-none-any.whl

app/server_settings.py

@@ -13,7 +13,4 @@ class ServerSettings(BaseSettings):
     BACKLOG_API_KEY: str
     BACKLOG_DOMAIN: str  # e.g., "your-space.backlog.com"
 
-    # User Settings
-    USER_ID: int
-
 settings = ServerSettings()

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/get_user_issue_list.py

@@ -1,69 +1,27 @@
 from app.utils.di import create_backlog_context
-from app.utils.ultils import get_user_task
+from app.utils.ultils import get_user_task, get_current_user
 
-from app.server_settings import settings
 
-
-async def get_user_issue_list(
-    project_ids: list[int] | None = None,
-    assignee_ids: list[int] | None = None,
-    status_ids: list[int] | None = None,
-    milestone_ids: list[int] | None = None,
-    parent_issue_ids: list[int] | None = None,
-    created_since: str | None = None,
-    created_until: str | None = None,
-    updated_since: str | None = None,
-    updated_until: str | None = None,
-    start_date_since: str | None = None,
-    start_date_until: str | None = None,
-    due_date_since: str | None = None,
-    due_date_until: str | None = None,
-):
+async def get_user_issue_list():
     """
-    Retrieves a filtered list of issues from Backlog for the users.
-
-    Args:
-        project_ids (list[int], optional): List of project IDs to filter issues.
-        assignee_ids (list[int], optional): List of assignee IDs to filter issues (defaults to current user).
-        status_ids (list[int], optional): List of status IDs to filter issues (defaults to all non-closed statuses).
-        milestone_ids (list[int], optional): List of milestone IDs to filter issues.
-        parent_issue_ids (list[int], optional): List of parent issue IDs to filter issues.
-
-        created_since (str, optional): Created since (YYYY-MM-DD).
-        created_until (str, optional): Created until (YYYY-MM-DD).
-
-        updated_since (str, optional): Updated since (YYYY-MM-DD).
-        updated_until (str, optional): Updated until (YYYY-MM-DD).
-
-        start_date_since (str, optional): Start Date since (YYYY-MM-DD).
-        start_date_until (str, optional): Start Date until (YYYY-MM-DD).
+    Retrieves a list of issues assigned to the current user from Backlog.
 
-        due_date_since (str, optional): Due Date since (YYYY-MM-DD).
-        due_date_until (str, optional): Due Date until (YYYY-MM-DD).
+    This function automatically determines the current user's ID via API
+    and returns only issues assigned to that user.
     """
 
     try:
         ctx = create_backlog_context()
 
-        if assignee_ids is None:
-            assignee_ids = [settings.USER_ID]
+        # Fetch current user information
+        current_user = await get_current_user(ctx.backlog_domain, ctx.api_key)
+        current_user_id = current_user["id"]
 
+        # Get issues assigned to current user
         issue_list = await get_user_task(
             backlog_domain=ctx.backlog_domain,
             api_key=ctx.api_key,
-            project_ids=project_ids,
-            assignee_ids=assignee_ids,
-            status_ids=status_ids,
-            milestone_ids=milestone_ids,
-            parent_issue_ids=parent_issue_ids,
-            created_since=created_since,
-            created_until=created_until,
-            updated_since=updated_since,
-            updated_until=updated_until,
-            start_date_since=start_date_since,
-            start_date_until=start_date_until,
-            due_date_since=due_date_since,
-            due_date_until=due_date_until
+            assignee_ids=[current_user_id]
         )
         return issue_list
     except Exception as 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:
@@ -267,3 +276,27 @@ async def get_project_list(backlog_domain: str, api_key: str) -> list[int]:
             raise ValueError(f"Failed to get project list: {e}") from e
         except Exception as e:
             raise ValueError(f"Unexpected error while getting project list: {e}") from e
+
+
+async def get_current_user(backlog_domain: str, api_key: str) -> dict:
+    """Get current user information from Backlog API.
+
+    Returns:
+        dict: {"id": int, "name": str}
+    """
+    url = f"{backlog_domain}api/v2/users/myself"
+    params = {"apiKey": api_key}
+
+    async with httpx.AsyncClient() as client:
+        try:
+            response = await client.get(url, params=params, timeout=10.0)
+            response.raise_for_status()
+            data = response.json()
+            return {
+                "id": data["id"],
+                "name": data["name"]
+            }
+        except httpx.HTTPError as e:
+            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

{backlog_mcp-1.0.2.dist-info → backlog_mcp-1.0.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: backlog-mcp
-Version: 1.0.2
+Version: 1.0.4
 Summary: A Model Context Protocol (MCP) server for Backlog project management integration
 Author-email: BaoNguyen <baonguyen@teqnological.asia>
 Requires-Python: <3.14,>=3.13
@@ -55,22 +55,9 @@ Get detailed information about a Backlog issue by its issue key.
 
 ### `get_user_issue_list`
 
-Retrieve a filtered list of issues based on project, assignees, milestones, and other criteria.
+Retrieve a list of issues assigned to the current user.
 
-**Parameters:**
-- `project_ids` (List[int], optional): List of project IDs.
-- `assignee_ids` (List[int], optional): List of assignee IDs (defaults to current user).
-- `status_ids` (List[int], optional): List of status IDs (defaults to non-closed).
-- `milestone_ids` (List[int], optional): List of milestone IDs.
-- `parent_issue_ids` (List[int], optional): List of parent issue IDs.
-- `created_since` (str, optional): Created since (YYYY-MM-DD).
-- `created_until` (str, optional): Created until (YYYY-MM-DD).
-- `updated_since` (str, optional): Updated since (YYYY-MM-DD).
-- `updated_until` (str, optional): Updated until (YYYY-MM-DD).
-- `start_date_since` (str, optional): Start Date since (YYYY-MM-DD).
-- `start_date_until` (str, optional): Start Date until (YYYY-MM-DD).
-- `due_date_since` (str, optional): Due Date since (YYYY-MM-DD).
-- `due_date_until` (str, optional): Due Date until (YYYY-MM-DD).
+This tool automatically determines the current user's ID and returns only issues assigned to that user. No parameters are required.
 
 ## Running the Server Locally
 
@@ -89,13 +76,11 @@ Create a `.env` file in the root directory and add the following environment var
 # Backlog API Settings
 BACKLOG_API_KEY=your_backlog_api_key_here
 BACKLOG_DOMAIN=your-space.backlog.com
-USER_ID=your_user_id
 ```
 
 > **Important:**
 > - Replace `your_backlog_api_key_here` with your actual Backlog API key
 > - Replace `your-space.backlog.com` with your actual Backlog domain
-> - Replace `your_user_id` with your actual Backlog user ID
 
 ### 3. Start the server
 

{backlog_mcp-1.0.2.dist-info → backlog_mcp-1.0.4.dist-info}/RECORD

@@ -1,19 +1,19 @@
 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/server_settings.py,sha256=OAyawcXWMipv1efsvG36zIiWDsdct5mVFbqlzEIFKVI,472
+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/get_user_issue_list.py,sha256=VACGgTybe2MHfVUqTqwqlq_7PNhR1r-t2i918n2JMgc,2706
+app/tools/get_issue_details.py,sha256=efixu906oloeIZdf-geTlLxt9nLe-tPDqUlDd9HL6-g,973
+app/tools/get_user_issue_list.py,sha256=soNX0OfvfT1hIyzeDMPaHpAjHeGqavtZdTl0CemCpyo,865
 app/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 app/utils/di.py,sha256=5MmL6efLAX3uzp5WSMi4E_BDCgapzlr_OERZoN5NGnM,408
-app/utils/ultils.py,sha256=ruRh2Ruet1y-ZYpFl4KRoDv7Qb1XLr5L581a4xF-kNk,9984
-backlog_mcp-1.0.2.dist-info/METADATA,sha256=AHQ5zRkIgdt0hwf2N_kp9AL9KAXskSK962bLVhVp724,4774
-backlog_mcp-1.0.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-backlog_mcp-1.0.2.dist-info/entry_points.txt,sha256=h5JeHYUp_uoaya4FO3QelcsgYOu-VRmh5qWRhPrwjtk,46
-backlog_mcp-1.0.2.dist-info/RECORD,,
+app/utils/ultils.py,sha256=HXa43zAOtyr0VdNHS2Du8CzqseAop2lsjGBPSMZnmb4,11400
+backlog_mcp-1.0.4.dist-info/METADATA,sha256=WWSScaN5867hmnddFdBrbls1dosDjmPLZ7wubzd67TM,3883
+backlog_mcp-1.0.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+backlog_mcp-1.0.4.dist-info/entry_points.txt,sha256=h5JeHYUp_uoaya4FO3QelcsgYOu-VRmh5qWRhPrwjtk,46
+backlog_mcp-1.0.4.dist-info/RECORD,,