backlog-mcp 1.0.2__tar.gz → 1.0.4__tar.gz

{backlog_mcp-1.0.2 → backlog_mcp-1.0.4}/.env.example

@@ -1,4 +1,3 @@
 # Backlog API Settings
 BACKLOG_API_KEY=your_backlog_api_key_here
 BACKLOG_DOMAIN=your-space.backlog.com
-USER_ID=your_user_id

{backlog_mcp-1.0.2 → backlog_mcp-1.0.4}/PKG-INFO

@@ -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 → backlog_mcp-1.0.4}/README.md

@@ -39,22 +39,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
 
@@ -73,13 +60,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 → backlog_mcp-1.0.4}/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()

{backlog_mcp-1.0.2 → backlog_mcp-1.0.4}/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:

backlog_mcp-1.0.4/app/tools/get_user_issue_list.py

@@ -0,0 +1,28 @@
+from app.utils.di import create_backlog_context
+from app.utils.ultils import get_user_task, get_current_user
+
+
+async def get_user_issue_list():
+    """
+    Retrieves a list of issues assigned to the current user from Backlog.
+
+    This function automatically determines the current user's ID via API
+    and returns only issues assigned to that user.
+    """
+
+    try:
+        ctx = create_backlog_context()
+
+        # 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,
+            assignee_ids=[current_user_id]
+        )
+        return issue_list
+    except Exception as e:
+        raise e

{backlog_mcp-1.0.2 → backlog_mcp-1.0.4}/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 → backlog_mcp-1.0.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "backlog-mcp"
-version = "1.0.2"
+version = "1.0.4"
 description = "A Model Context Protocol (MCP) server for Backlog project management integration"
 authors = [{name = "BaoNguyen", email = "baonguyen@teqnological.asia"}]
 readme = "README.md"

{backlog_mcp-1.0.2 → backlog_mcp-1.0.4}/scripts/install-backlog-mcp.sh

@@ -187,11 +187,11 @@ case $agent_choice in
         AGENT_KEY="cline"
         CONFIG_FORMAT="standard"
         SERVERS_KEY="mcpServers"
-        TIMEOUT_VALUE=""
-        HAS_TYPE="false"
-        HAS_AUTO_APPROVE="false"
-        HAS_DISABLED="false"
-        HAS_TIMEOUT="false"
+        TIMEOUT_VALUE="60"
+        HAS_TYPE="true"
+        HAS_AUTO_APPROVE="true"
+        HAS_DISABLED="true"
+        HAS_TIMEOUT="true"
         CONFIG_FILE="$HOME/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json"
         ;;
     2)
@@ -200,11 +200,11 @@ case $agent_choice in
         AGENT_KEY="copilot"
         CONFIG_FORMAT="copilot"
         SERVERS_KEY="servers"
-        TIMEOUT_VALUE=""
-        HAS_TYPE="false"
+        TIMEOUT_VALUE="60"
+        HAS_TYPE="true"
         HAS_AUTO_APPROVE="false"
         HAS_DISABLED="false"
-        HAS_TIMEOUT="false"
+        HAS_TIMEOUT="true"
         CONFIG_FILE="$HOME/Library/Application Support/Code/User/mcp.json"
         ;;
     3)
@@ -439,21 +439,6 @@ while [ -z "$BACKLOG_API_KEY" ]; do
 done
 echo ""
 
-# Note: BACKLOG_DOMAIN is Fixed - no prompt generated, value will be hardcoded
-
-# USER_ID (Variable - will be prompted)
-echo -e "${CYAN}  ℹ️  USER_ID${NC}"
-echo -e "${YELLOW}     ⚠️  Required: Please enter your USER_ID${NC}"
-while [ -z "$USER_ID" ]; do
-    read -p "  🔐 Enter USER_ID: " USER_ID
-    if [ -z "$USER_ID" ]; then
-        echo -e "${RED}  ✗ USER_ID cannot be empty. Please try again.${NC}"
-    else
-        echo -e "${GREEN}  ✓ USER_ID set: $USER_ID${NC}"
-    fi
-done
-echo ""
-
 echo ""
 echo -e "${WHITE}  ════════════════════════════════════════════════════════${NC}"
 echo ""
@@ -486,7 +471,7 @@ echo ""
 mkdir -p "$(dirname "$CONFIG_FILE")"
 
 # Validate and merge using Python
-python3 - "$CONFIG_FILE" "$OVERWRITE_MODE" "$SERVERS_KEY" "$TIMEOUT_VALUE" "$HAS_TYPE" "$HAS_AUTO_APPROVE" "$HAS_DISABLED" "$HAS_TIMEOUT" "$CONFIG_FORMAT" "backlog-mcp" "uvx" "backlog-mcp@latest" "ENV_START" "BACKLOG_API_KEY=$BACKLOG_API_KEY" "BACKLOG_DOMAIN=teq-dev.backlog.com" "USER_ID=$USER_ID" << 'PYTHON_EOF'
+python3 - "$CONFIG_FILE" "$OVERWRITE_MODE" "$SERVERS_KEY" "$TIMEOUT_VALUE" "$HAS_TYPE" "$HAS_AUTO_APPROVE" "$HAS_DISABLED" "$HAS_TIMEOUT" "$CONFIG_FORMAT" "backlog-mcp" "uvx" "backlog-mcp@latest" "ENV_START" "BACKLOG_API_KEY=$BACKLOG_API_KEY" "BACKLOG_DOMAIN=teq-dev.backlog.com" << 'PYTHON_EOF'
 import json
 import sys
 import os
@@ -650,7 +635,7 @@ if has_type:
     mcp_config["type"] = "stdio"
 
 if has_auto_approve:
-    mcp_config["autoApprove"] = []
+    mcp_config["autoApprove"] = ["get_issue_details", "get_user_issue_list"]
 
 if has_disabled:
     mcp_config["disabled"] = False

{backlog_mcp-1.0.2 → backlog_mcp-1.0.4}/uv.lock

@@ -1,5 +1,5 @@
 version = 1
-revision = 2
+revision = 3
 requires-python = "==3.13.*"
 
 [[package]]
@@ -34,7 +34,7 @@ wheels = [
 
 [[package]]
 name = "backlog-mcp"
-version = "0.0.10"
+version = "1.0.3"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },

backlog_mcp-1.0.2/app/tools/get_user_issue_list.py

@@ -1,70 +0,0 @@
-from app.utils.di import create_backlog_context
-from app.utils.ultils import get_user_task
-
-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,
-):
-    """
-    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).
-
-        due_date_since (str, optional): Due Date since (YYYY-MM-DD).
-        due_date_until (str, optional): Due Date until (YYYY-MM-DD).
-    """
-
-    try:
-        ctx = create_backlog_context()
-
-        if assignee_ids is None:
-            assignee_ids = [settings.USER_ID]
-
-        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
-        )
-        return issue_list
-    except Exception as e:
-        raise e