backlog-mcp 1.0.5__tar.gz → 1.0.7__tar.gz

{backlog_mcp-1.0.5 → backlog_mcp-1.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: backlog-mcp
-Version: 1.0.5
+Version: 1.0.7
 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.5 → backlog_mcp-1.0.7}/app/main.py

@@ -10,6 +10,8 @@ app = FastMCP(
 
 # Add tool for Backlog MCP
 app.add_tool(get_issue_details)
+app.add_tool(get_my_issues)
+app.add_tool(get_users_by_project)
 app.add_tool(get_user_issue_list)
 app.add_tool(update_issue_description)
 

{backlog_mcp-1.0.5 → backlog_mcp-1.0.7}/app/tools/__init__.py

@@ -1,3 +1,5 @@
 from .get_issue_details import *
+from .get_my_issues import *
+from .get_users_by_project import *
 from .get_user_issue_list import *
 from .update_issue_description import *

backlog_mcp-1.0.7/app/tools/get_my_issues.py

@@ -0,0 +1,28 @@
+from app.utils.di import create_backlog_context
+from app.utils.ultils import get_current_user, get_user_task
+
+async def get_my_issues():
+    """
+    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.
+
+    Returns:
+        List of issues with {issueKey, title}
+    """
+    try:
+        ctx = create_backlog_context()
+        current_user = await get_current_user(
+            backlog_domain=ctx.backlog_domain,
+            api_key=ctx.api_key,
+        )
+
+        issues = await get_user_task(
+            backlog_domain=ctx.backlog_domain,
+            api_key=ctx.api_key,
+            assignee_ids=[current_user["id"]],
+        )
+        return issues
+    except Exception as e:
+        raise e

backlog_mcp-1.0.7/app/tools/get_user_issue_list.py

@@ -0,0 +1,26 @@
+from app.utils.di import create_backlog_context
+from app.utils.ultils import get_user_task
+
+async def get_user_issue_list(user_id: int):
+    """
+    Get issues assigned to a specific user.
+
+    Args:
+        user_id (int): The Backlog user ID to filter issues by.
+
+    Returns:
+        List of issues with {issueKey, title}
+    """
+    try:
+        if not user_id:
+            raise ValueError("Please provide a user ID.")
+
+        ctx = create_backlog_context()
+        issues = await get_user_task(
+            backlog_domain=ctx.backlog_domain,
+            api_key=ctx.api_key,
+            assignee_ids=[user_id],
+        )
+        return issues
+    except Exception as e:
+        raise e

backlog_mcp-1.0.7/app/tools/get_users_by_project.py

@@ -0,0 +1,24 @@
+from app.utils.di import create_backlog_context
+from app.utils.ultils import get_project_users
+
+async def get_users_by_project(project_key: str):
+    """
+    Get all users in a specific project.
+
+    Args:
+        project_key (str): Project key to search users in (e.g., 'PROJ')
+
+    Returns:
+        List of all users with {id, name, mailAddress}
+    """
+    try:
+        ctx = create_backlog_context()
+        project_users = await get_project_users(
+            backlog_domain=ctx.backlog_domain,
+            api_key=ctx.api_key,
+            project_key=project_key
+        )
+
+        return project_users
+    except Exception as e:
+        raise e

{backlog_mcp-1.0.5 → backlog_mcp-1.0.7}/app/tools/update_issue_description.py

@@ -7,7 +7,10 @@ async def update_issue_description(
     description: str,
 ):
     """
-    Update the description of a Backlog issue.
+    Updates the description of a Backlog issue.
+
+    IMPORTANT: Call this tool directly when all parameters are provided. 
+    Do NOT call other tools to check issue existence beforehand.
 
     Args:
         issue_key (str): The key or ID of the Backlog issue to update.

{backlog_mcp-1.0.5 → backlog_mcp-1.0.7}/app/utils/ultils.py

@@ -301,6 +301,38 @@ async def get_current_user(backlog_domain: str, api_key: str) -> dict:
         except Exception as e:
             raise ValueError(f"Unexpected error while getting current user: {e}") from e
 
+async def get_project_users(backlog_domain: str, api_key: str, project_key: str) -> list[dict]:
+    """Get users in a specific project (requires only project access, not admin).
+
+    Args:
+        backlog_domain (str): Backlog domain URL
+        api_key (str): API key for authentication
+        project_key (str): Project key (e.g., 'PROJ')
+
+    Returns:
+        list[dict]: List of users with {id, name, mailAddress}
+    """
+    url = f"{backlog_domain}api/v2/projects/{project_key}/users"
+    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": user["id"],
+                    "name": user["name"],
+                    "mailAddress": user.get("mailAddress")
+                }
+                for user in data
+            ]
+        except httpx.HTTPError as e:
+            raise ValueError(f"Failed to get project users: {e}") from e
+        except Exception as e:
+            raise ValueError(f"Unexpected error while getting project users: {e}") from e
+
 
 async def update_issue_description_handler(
     backlog_domain: str,

{backlog_mcp-1.0.5 → backlog_mcp-1.0.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "backlog-mcp"
-version = "1.0.5"
+version = "1.0.7"
 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.5 → backlog_mcp-1.0.7}/uv.lock

@@ -34,7 +34,7 @@ wheels = [
 
 [[package]]
 name = "backlog-mcp"
-version = "1.0.4"
+version = "1.0.7"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },

backlog_mcp-1.0.5/app/tools/get_user_issue_list.py

@@ -1,28 +0,0 @@
-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