mediawiki-mcp-server

Instructions

Implementation Reference

• src/tools/update-page.ts:30-55 (handler)

  The handler function that executes the tool logic: makes a REST PUT request to update the wiki page with new source, using the provided latest revision ID as base, handles errors, and returns formatted result.

  async function handleUpdatePageTool(
  	title: string,
  	source: string,
  	latestId: number,
  	comment?: string
  ): Promise<CallToolResult> {
  	let data: MwRestApiPageObject;
  	try {
  		data = await makeRestPutRequest<MwRestApiPageObject>( `/v1/page/${ encodeURIComponent( title ) }`, {
  			source: source,
  			comment: formatEditComment( 'update-page', comment ),
  			latest: { id: latestId }
  		}, true );
  	} catch ( error ) {
  		return {
  			content: [
  				{ type: 'text', text: `Failed to update page: ${ ( error as Error ).message }` } as TextContent
  			],
  			isError: true
  		};
  	}
  
  	return {
  		content: updatePageToolResult( data )
  	};
  }

• src/tools/update-page.ts:9-28 (registration)

  Registers the 'update-page' tool with the MCP server, defines input schema using Zod, tool annotations, and links to the handler function.

  export function updatePageTool( server: McpServer ): RegisteredTool {
  	return server.tool(
  		'update-page',
  		'Updates a wiki page. Replaces the existing content of a page with the provided content',
  		{
  			title: z.string().describe( 'Wiki page title' ),
  			source: z.string().describe( 'Page content in the same content model of the existing page' ),
  			latestId: z.number().int().positive().describe( 'Revision ID used as the base for the new source' ),
  			comment: z.string().optional().describe( 'Summary of the edit' )
  		},
  		{
  			title: 'Update page',
  			readOnlyHint: false,
  			destructiveHint: true
  		} as ToolAnnotations,
  		async (
  			{ title, source, latestId, comment }
  		) => handleUpdatePageTool( title, source, latestId, comment )
  	);
  }

• src/tools/update-page.ts:57-77 (helper)

  Helper function to format the successful update result into TextContent array with page details.

  function updatePageToolResult( result: MwRestApiPageObject ): TextContent[] {
  	return [
  		{
  			type: 'text',
  			text: `Page updated successfully: ${ getPageUrl( result.title ) }`
  		},
  		{
  			type: 'text',
  			text: [
  				'Page object:',
  				`Page ID: ${ result.id }`,
  				`Title: ${ result.title }`,
  				`Latest revision ID: ${ result.latest.id }`,
  				`Latest revision timestamp: ${ result.latest.timestamp }`,
  				`Content model: ${ result.content_model }`,
  				`License: ${ result.license.url } ${ result.license.title }`,
  				`HTML URL: ${ result.html_url }`
  			].join( '\n' )
  		}
  	];
  }

• src/tools/index.ts:22-51 (registration)

  Top-level registration: includes updatePageTool in the list of registrars and calls them all to register tools with the MCP server.

  const toolRegistrars = [
  	getPageTool,
  	getPageHistoryTool,
  	searchPageTool,
  	setWikiTool,
  	addWikiTool,
  	removeWikiTool,
  	updatePageTool,
  	getFileTool,
  	createPageTool,
  	uploadFileTool,
  	uploadFileFromUrlTool,
  	deletePageTool,
  	getRevisionTool,
  	undeletePageTool,
  	getCategoryMembersTool,
  	searchPageByPrefixTool
  ];
  
  export function registerAllTools( server: McpServer ): RegisteredTool[] {
  	const registeredTools: RegisteredTool[] = [];
  	for ( const registrar of toolRegistrars ) {
  		try {
  			registeredTools.push( registrar( server ) );
  		} catch ( error ) {
  			console.error( `Error registering tool: ${ ( error as Error ).message }` );
  		}
  	}
  	return registeredTools;
  }