Azure DevOps MCP Server for Cline

Instructions

Implementation Reference

• src/tools/board/get.ts:8-28 (handler)

  Core handler function that executes the get_boards tool logic: initializes connection, fetches boards via Azure DevOps Work API, and formats response.

  export async function getBoards(args: GetBoardsArgs, config: AzureDevOpsConfig) {
    AzureDevOpsConnection.initialize(config);
    const connection = AzureDevOpsConnection.getInstance();
    const workApi = await connection.getWorkApi();
    
    const teamContext = {
      project: config.project,
      team: args.team || `${config.project} Team`,
    };
  
    const boards = await workApi.getBoards(teamContext);
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(boards, null, 2),
        },
      ],
    };
  }

• src/tools/board/get.ts:4-6 (schema)

  Type definition for input arguments to the get_boards handler.

  interface GetBoardsArgs {
    team?: string;
  }

• src/tools/board/index.ts:4-18 (schema)

  MCP tool definition schema for get_boards, including name, description, and input schema.

  const definitions = [
    {
      name: 'get_boards',
      description: 'List available boards in the project',
      inputSchema: {
        type: 'object',
        properties: {
          team: {
            type: 'string',
            description: 'Team name (optional)',
          },
        },
      },
    },
  ];

• src/tools/board/index.ts:20-25 (registration)

  Registers the getBoards handler within boardTools.initialize, binding config, and exports definitions.

  export const boardTools = {
    initialize: (config: AzureDevOpsConfig) => ({
      getBoards: (args: any) => getBoards(args, config),
      definitions,
    }),
    definitions,

• src/index.ts:134-136 (registration)

  Main server request handler dispatches 'get_boards' tool calls to the bound handler.

  case 'get_boards':
    result = await tools.board.getBoards(request.params.arguments);
    break;