Azure DevOps Wiki MCP Server

Instructions

Implementation Reference

• src/server.ts:312-333 (handler)

  The primary handler for the 'list_wiki' tool. Parses input using WikiListRequestSchema, initializes client if needed, calls client.listWikis(), and returns JSON-formatted list of wikis.

  private async handleListWiki(args: any) {
    const request = WikiListRequestSchema.parse(args);
    const organization = request.organization || this.config.defaultOrganization;
    const project = request.project || this.config.defaultProject;
    
    if (!organization) {
      throw new Error('Organization is required either as parameter or in server configuration');
    }
    if (!project) {
      throw new Error('Project is required either as parameter or in server configuration');
    }
    
    const client = await this.getClient(organization, project);
    const wikis = await client.listWikis(request);
    
    return {
      content: [{
        type: 'text',
        text: JSON.stringify(wikis, null, 2)
      }]
    };
  }

• src/types.ts:32-35 (schema)

  Zod schema for validating input parameters to the list_wiki tool (organization and project are optional).

  export const WikiListRequestSchema = z.object({
    organization: z.string().min(1).optional(),
    project: z.string().min(1).optional(),
  });

• src/server.ts:138-155 (registration)

  Registration of the 'list_wiki' tool in the MCP server's ListToolsRequestHandler, including name, description, and input schema definition.

  {
    name: 'list_wiki',
    description: 'List all wikis in a project',
    inputSchema: {
      type: 'object',
      properties: {
        organization: {
          type: 'string',
          description: 'Azure DevOps organization name'
        },
        project: {
          type: 'string',
          description: 'Project name'
        }
      },
      required: []
    }
  }

• src/azure-client.ts:397-429 (helper)

  Helper method in AzureDevOpsWikiClient that performs the actual API call to Azure DevOps WikiApi.getAllWikis(project) and maps the response to WikiInfo[] format.

  async listWikis(request: WikiListRequest): Promise<WikiInfo[]> {
    if (!this.wikiApi || !this.connection) {
      throw new Error('Azure DevOps client not initialized');
    }
  
    try {
      const organization = request.organization || this.config.organization;
      const project = request.project || this.config.project;
      
      if (!organization || !project) {
        throw new Error('Organization and project must be provided');
      }
  
      const wikis = await this.wikiApi.getAllWikis(project);
      
      if (!wikis || !Array.isArray(wikis)) {
        return [];
      }
  
      return wikis.map(wiki => ({
        id: wiki.id || '',
        name: wiki.name || '',
        type: wiki.type?.toString() || '',
        url: wiki.url || '',
        project: project,
        repositoryId: wiki.repositoryId || '',
        mappedPath: wiki.mappedPath || ''
      }));
  
    } catch (error) {
      throw new Error(`Failed to list wikis: ${error instanceof Error ? error.message : String(error)}`);
    }
  }

• src/types.ts:82-89 (schema)

  TypeScript interface defining the structure of WikiInfo objects returned by the list_wiki tool.

  export interface WikiInfo {
    id: string;
    name: string;
    type: string;
    url: string;
    project: string;
    repositoryId: string;
    mappedPath: string;