MCP Azure DevOps Server

Instructions

Implementation Reference

• mcp_azure_devops/azure_devops_client.py:121-147 (handler)

  Core handler function that constructs the JSON patch operations for field updates and relations, then invokes the Azure DevOps API to update the work item.

  def update_work_item(self, work_item_id, updates, relations=None):
      patch_document = [
          JsonPatchOperation(
              op="add",
              path=f"/fields/{field}",
              value=value
          ) for field, value in updates.items()
      ]
  
      if relations:
          for relation in relations:
              patch_document.append(
                  JsonPatchOperation(
                      op="add",
                      path="/relations/-",
                      value={
                          "rel": relation["rel"],
                          "url": relation["url"]
                      }
                  )
              )
      
      return self.work_item_tracking_client.update_work_item(
          document=patch_document,
          id=work_item_id
      )

• mcp_azure_devops/server.py:124-160 (schema)

  Defines the input schema and description for the update_work_item tool, specifying parameters work_item_id, updates, and optional relations.

  types.Tool(
      name="update_work_item",
      description="Updates a work item by its ID with field changes and relation management.",
      inputSchema={
          "type": "object",
          "properties": {
              "work_item_id": {
                  "type": "integer", 
                  "description": "The ID of the work item to update."
              },
              "updates": {
                  "type": "object", 
                  "description": "A dictionary of fields to update."
              },
              "relations": {
                  "type": "array",
                  "description": "A list of relations to other work items.",
                  "items": {
                      "type": "object",
                      "properties": {
                          "rel": {
                              "type": "string", 
                              "description": "The relation type (e.g., 'System.LinkTypes.Dependency-Forward')."
                          },
                          "url": {
                              "type": "string", 
                              "description": "The URL of the related work item."
                          }
                      },
                      "required": ["rel", "url"]
                  }
              }
          },
          "required": ["work_item_id", "updates"],
          "additionalProperties": False
      }
  ),

• mcp_azure_devops/server.py:912-919 (handler)

  MCP server dispatch handler that calls the client.update_work_item method with tool arguments and formats the response.

  elif name == "update_work_item":
      work_item = self.client.update_work_item(**arguments)
      return {
          "id": work_item.id,
          "url": work_item.url,
          "title": work_item.fields.get('System.Title', 'N/A'),
          "state": work_item.fields.get('System.State', 'N/A')
      }

• mcp_azure_devops/server.py:857-862 (registration)

  Registers the list of tools including update_work_item via the MCP list_tools handler.

  @self.server.list_tools()
  async def list_tools() -> List[types.Tool]:
      """Return the list of available tools."""
      logger.info(f"Tools requested - returning {len(self.tools)} tools")
      self.tools_registered = True
      return self.tools