MCP Azure DevOps Server

Instructions

Implementation Reference

• mcp_azure_devops/server.py:1069-1089 (handler)

  Executes the server_health_check tool logic by validating server environment, client status, tool registration, and testing Azure DevOps connection via get_projects().

  async def _health_check(self) -> Dict[str, Any]:
      """Perform comprehensive health check."""
      health_status = {
          "server_status": "healthy",
          "environment_check": self._validate_environment(),
          "client_initialized": self.client is not None,
          "tools_registered": self.tools_registered,
          "total_tools": len(self.tools),
          "azure_devops_connection": "unknown"
      }
      
      if self.client:
          try:
              # Test Azure DevOps connection
              projects = self.client.get_projects()
              health_status["azure_devops_connection"] = "connected"
              health_status["available_projects"] = len(projects)
          except Exception as e:
              health_status["azure_devops_connection"] = f"error: {str(e)}"
      
      return health_status

• mcp_azure_devops/server.py:578-586 (schema)

  Defines the input schema, description, and registers the server_health_check tool in the self.tools list.

  types.Tool(
      name="server_health_check",
      description="Performs a comprehensive health check of the server and Azure DevOps connection.",
      inputSchema={
          "type": "object",
          "properties": {},
          "additionalProperties": False
      }
  ),

• mcp_azure_devops/server.py:895-896 (registration)

  Dispatches the server_health_check tool call to the _health_check handler in _execute_tool method.

  if name == "server_health_check":
      return await self._health_check()

• validate_setup.py:147-157 (helper)

  Helper code in setup validation script that checks for presence of server_health_check among key tools.

  key_tools = ['create_work_item', 'get_work_item', 'create_wiki_page', 'server_health_check']
  found_tools = [tool.name for tool in server.tools if tool.name in key_tools]
  
  for tool in found_tools:
      self.log_info(f"  ✓ {tool}")
  
  missing_tools = set(key_tools) - set(found_tools)
  for tool in missing_tools:
      self.log_warning(f"  ✗ {tool} (not found)")
  
  return tools_count > 0