ZeroPath MCP Server

Instructions

List all repositories in the organization.

Args:
    search_query: Optional search term to filter repositories

Implementation Reference

• src/zeropath_mcp_server/server.py:450-474 (handler)

  The main handler function for the 'list_repositories' MCP tool. It makes an API request to ZeroPath's repositories/list endpoint, handles the response, and formats it using a helper function.

  @mcp.tool()
  def list_repositories(search_query: str = None) -> str:
      """
      List all repositories in the organization.
  
      Args:
          search_query: Optional search term to filter repositories
      """
      payload = {}
      if search_query:
          payload["searchQuery"] = search_query
  
      response, error = make_api_request("repositories/list", payload)
  
      if error:
          return error
  
      if response.status_code == 200:
          return process_repositories_response(response.json())
      elif response.status_code == 401:
          return "Error: Unauthorized - check API credentials"
      elif response.status_code == 400:
          return f"Error: Bad request - {response.text}"
      else:
          return f"Error: API returned status {response.status_code}: {response.text}"

• src/zeropath_mcp_server/server.py:477-504 (helper)

  Helper function that processes the raw API response from repositories/list into a human-readable formatted string listing repository details.

  def process_repositories_response(raw_response):
      """Process repositories list response into readable format."""
      # Handle list response directly
      if isinstance(raw_response, list):
          repos = raw_response
      else:
          if "error" in raw_response:
              return f"Error: {raw_response['error']}"
          repos = raw_response.get("repositories", raw_response.get("items", []))
  
      if not repos:
          return "No repositories found."
  
      total_count = len(repos)
      result = f"Found {total_count} repository(ies).\n\n"
  
      for i, repo in enumerate(repos, 1):
          result += f"Repository {i}:\n"
          result += f"  ID: {repo.get('id', 'N/A')}\n"
          result += f"  Name: {repo.get('name', 'N/A')}\n"
          result += f"  Full Name: {repo.get('fullName', repo.get('full_name', 'N/A'))}\n"
          result += f"  Provider: {repo.get('provider', 'N/A')}\n"
          result += f"  Default Branch: {repo.get('defaultBranch', repo.get('scanBranch', 'N/A'))}\n"
          result += f"  PR Scanning: {repo.get('prScanningEnabled', 'N/A')}\n"
          result += f"  Last Scanned: {repo.get('lastScannedAt', 'N/A')}\n"
          result += "\n"
  
      return result

• src/zeropath_mcp_server/server.py:450-450 (registration)

  The @mcp.tool() decorator registers the list_repositories function as an MCP tool.

  @mcp.tool()