unstar_project

Instructions

Args:
    project_id: GitLab project ID
    token: GitLab Personal Access Token (optional)
    ctx: MCP context (automatically injected)

Implementation Reference

• gitlab_clone_mcp_server/server.py:1140-1154 (handler)

  The 'unstar_project' tool handler function. It makes a POST request to the GitLab API endpoint /projects/{project_id}/unstar to unstar a project. The function takes a project_id parameter, an optional token, and an optional context. It returns a success message with the project name and updated star count, or an error message on failure.

  @mcp.tool()
  async def unstar_project(project_id: int, token: str = None, ctx=None) -> str:
      """Unstar a project.
      
      Args:
          project_id: GitLab project ID
          token: GitLab Personal Access Token (optional)
          ctx: MCP context (automatically injected)
      """
      result = await make_gitlab_request(f"/projects/{project_id}/unstar", "POST", ctx=ctx, token=token)
      
      if isinstance(result, dict) and "error" in result:
          return f"Error unstarring project: {result['error']}"
      
      return f"Project unstarred: {result['name']} (Stars: {result['star_count']})"

• gitlab_clone_mcp_server/server.py:1141-1141 (registration)

  The tool is registered via the @mcp.tool() decorator on line 1140, which registers unstar_project as a FastMCP tool with the name matching the function name.

  async def unstar_project(project_id: int, token: str = None, ctx=None) -> str:

• gitlab_clone_mcp_server/server.py:1141-1148 (schema)

  The function signature and docstring define the schema: project_id (int, required), token (str, optional), ctx (automatically injected). The return type is str. Type hints are provided in the function signature.

  async def unstar_project(project_id: int, token: str = None, ctx=None) -> str:
      """Unstar a project.
      
      Args:
          project_id: GitLab project ID
          token: GitLab Personal Access Token (optional)
          ctx: MCP context (automatically injected)
      """

• gitlab_clone_mcp_server/server.py:11-52 (helper)

  The make_gitlab_request helper function is used by unstar_project to make the actual HTTP POST request to the GitLab API. It handles token resolution (from parameter, request context, or environment variable), constructs the URL, and sends the request with error handling.

  async def make_gitlab_request(endpoint: str, method: str = "GET", data: dict = None, ctx=None, token: str = None) -> dict[str, Any] | None:
      """Make a request to GitLab API with proper error handling."""
      # Priority: 1. Explicit token parameter, 2. Context headers, 3. Environment variable
      
      # If no explicit token provided, try to get from context
      if not token and ctx and hasattr(ctx, 'request_context') and ctx.request_context:
          # Try to get from request headers
          if hasattr(ctx.request_context, 'headers'):
              token = ctx.request_context.headers.get('GITLAB_TOKEN')
      
      # Fallback to environment variable
      if not token:
          token = os.getenv("GITLAB_TOKEN")
      
      if not token:
          return {"error": "GitLab token not provided. Please provide a token parameter, GITLAB_TOKEN in the request headers, or set the environment variable."}
      
      # Get GitLab URL (from context or environment)
      gitlab_url = os.getenv("GITLAB_URL", "https://gitlab.com")
      
      headers = {
          "PRIVATE-TOKEN": token,
          "Content-Type": "application/json"
      }
      
      url = f"{gitlab_url}/api/v4{endpoint}"
      
      async with httpx.AsyncClient() as client:
          try:
              if method == "GET":
                  response = await client.get(url, headers=headers, timeout=30.0)
              elif method == "POST":
                  response = await client.post(url, headers=headers, json=data, timeout=30.0)
              elif method == "PUT":
                  response = await client.put(url, headers=headers, json=data, timeout=30.0)
              elif method == "DELETE":
                  response = await client.delete(url, headers=headers, timeout=30.0)
              
              response.raise_for_status()
              return response.json() if response.content else {"success": True}
          except Exception as e:
              return {"error": str(e)}