Minecraft Wiki MCP

Instructions

Implementation Reference

• src/services/wiki.service.ts:59-76 (handler)

  The main handler function that implements the tool logic by calling the MediaWiki parse API to retrieve a specific section of a page, sanitizes the content, and returns formatted JSON.
  async getPageSection(title: string, sectionIndex: number): Promise<string> { const response = await apiService.get<WikiResponse, Record<string, unknown>>("", { action: "parse", page: title, section: sectionIndex, }); if (!response.parse?.text?.["*"]) { throw new Error(`No content found for section ${sectionIndex} of "${title}"`); } const content = sanitizeWikiContent(response.parse.text["*"]); return JSON.stringify({ title: formatMCPText(title), sectionIndex: sectionIndex, content: content, }); }
• src/types/tools.ts:20-39 (schema)

  The Tool object defining the schema, name, description, and input schema (title: string, sectionIndex: number) for the MinecraftWiki_getPageSection tool.
  export const GET_PAGE_SECTION_MINECRAFTWIKI_TOOL: Tool = { name: "MinecraftWiki_getPageSection", description: "Get a specific section from a Minecraft Wiki page. Should be used as step 3 after searching for the page and getting its summary. The section index corresponds to the order of sections on the page, starting with 0 for the main content, 1 for the first section, 2 for the second section, etc.", inputSchema: { type: "object", properties: { title: { type: "string", description: "Title of the Minecraft Wiki page", }, sectionIndex: { type: "number", description: "Index of the section to retrieve (0 = main, 1 = first section, 2 = second section, etc.)", }, }, required: ["title", "sectionIndex"], }, };
• src/server.ts:82-88 (registration)

  Registration of the tool handler in the MCP server's CallToolRequestSchema switch statement, which validates arguments using the guard and calls the wikiService handler.
  case GET_PAGE_SECTION_MINECRAFTWIKI_TOOL.name: { if (!isGetPageSectionArgs(args)) { throw new Error("Invalid arguments for getPageSection"); } const section = await wikiService.getPageSection(args.title, args.sectionIndex); return { content: [{ type: "text", text: section }] }; }
• src/server.ts:49-60 (registration)

  Registration of the tool in the ListToolsRequestSchema handler, making it discoverable by clients.
  server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [ SEARCH_WIKI_MINECRAFTWIKI_TOOL, GET_PAGE_SUMMARY_MINECRAFTWIKI_TOOL, GET_SECTIONS_IN_PAGE_MINECRAFTWIKI_TOOL, GET_PAGE_SECTION_MINECRAFTWIKI_TOOL, GET_PAGE_CONTENT_MINECRAFTWIKI_TOOL, RESOLVE_REDIRECT_MINECRAFTWIKI_TOOL, LIST_CATEGORY_MEMBERS_MINECRAFTWIKI_TOOL, LIST_ALL_CATEGORIES_MINECRAFTWIKI_TOOL, GET_CATEGORIES_FOR_PAGE_MINECRAFTWIKI_TOOL, ],
• src/types/guards.ts:11-22 (helper)

  Type guard function for validating input arguments matching the tool schema (title: string, sectionIndex: number).
  export function isGetPageSectionArgs( args: unknown ): args is { title: string; sectionIndex: number } { return ( typeof args === "object" && args !== null && "title" in args && typeof (args as { title: string }).title === "string" && "sectionIndex" in args && typeof (args as { sectionIndex: number }).sectionIndex === "number" ); }
• src/utils/utils.ts:40-48 (helper)

  Helper function to sanitize wiki HTML content by removing tags, decoding escapes, and formatting for MCP compatibility, used in the handler.
  export function sanitizeWikiContent(text: string): string { return formatMCPText( // First decode any Unicode escapes decodeUnicodeEscapes( // Remove HTML tags text.replace(/<[^>]*>/g, " ") ) ); }