mediawiki-mcp-server

Instructions

Implementation Reference

• src/tools/upload-file-from-url.ts:32-71 (handler)

  Main execution logic for the 'upload-file-from-url' tool. Handles the upload via mwn.uploadFromUrl, specific error handling for disabled URL uploads, and returns success or error results.

  async function handleUploadFileFromUrlTool(
  	url: string, title: string, text: string, comment?: string
  ): Promise< CallToolResult > {
  
  	let data: ApiUploadResponse;
  	try {
  		const mwn = await getMwn();
  		data = await mwn.uploadFromUrl( url, title, text, getApiUploadParams( comment ) );
  	} catch ( error ) {
  		const errorMessage = ( error as Error ).message;
  
  		// Prevent the LLM from attempting to find an existing image on the wiki
  		// after failing to upload by URL.
  		if ( errorMessage.includes( 'copyuploaddisabled' ) ) {
  			return {
  				content: [
  					{
  						type: 'text',
  						text: 'Upload failed: Upload by URL is disabled for this wiki. Please download the image from the URL to the local disk first, then use the upload-file tool to upload it from the local file path.'
  					} as TextContent
  				],
  				isError: true
  			};
  		}
  
  		return {
  			content: [
  				{
  					type: 'text',
  					text: `Upload failed: ${ ( error as Error ).message }`
  				} as TextContent
  			],
  			isError: true
  		};
  	}
  
  	return {
  		content: uploadFileFromUrlToolResult( data )
  	};
  }

• src/tools/upload-file-from-url.ts:11-30 (registration)

  Registers the 'upload-file-from-url' tool with the MCP server, including name, description, input schema (Zod), annotations, and handler function reference. This also defines the schema.

  export function uploadFileFromUrlTool( server: McpServer ): RegisteredTool {
  	return server.tool(
  		'upload-file-from-url',
  		'Uploads a file to the wiki from a web URL.',
  		{
  			url: z.string().url().describe( 'URL of the file to upload' ),
  			title: z.string().describe( 'File title' ),
  			text: z.string().describe( 'Wikitext on the file page' ),
  			comment: z.string().optional().describe( 'Reason for uploading the file' )
  		},
  		{
  			title: 'Upload file from URL',
  			readOnlyHint: false,
  			destructiveHint: true
  		} as ToolAnnotations,
  		async (
  			{ url, title, text, comment }
  		) => handleUploadFileFromUrlTool( url, title, text, comment )
  	);
  }

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

  Imports the uploadFileFromUrlTool registrar and includes it in the toolRegistrars array. The registerAllTools function iterates over registrars to register all tools including this one.

  import { uploadFileFromUrlTool } from './upload-file-from-url.js';
  import { deletePageTool } from './delete-page.js';
  import { getRevisionTool } from './get-revision.js';
  import { undeletePageTool } from './undelete-page.js';
  import { getCategoryMembersTool } from './get-category-members.js';
  import { searchPageByPrefixTool } from './search-page-by-prefix.js';
  
  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;
  }

• src/tools/upload-file-from-url.ts:73-77 (helper)

  Helper function to prepare API upload parameters, formatting the edit comment specifically for this tool.

  function getApiUploadParams( comment?: string ): ApiUploadParams {
  	return {
  		comment: formatEditComment( 'upload-file-from-url', comment )
  	};
  }

• src/tools/upload-file-from-url.ts:79-93 (helper)

  Helper function to format the successful upload response as an array of TextContent blocks.

  function uploadFileFromUrlToolResult( data: ApiUploadResponse ): TextContent[] {
  	const result: TextContent[] = [
  		{
  			type: 'text',
  			text: 'File uploaded successfully from URL'
  		}
  	];
  
  	result.push( {
  		type: 'text',
  		text: `Upload details: ${ JSON.stringify( data, null, 2 ) }`
  	} );
  
  	return result;
  }