get_eve_wiki_article

Instructions

Implementation Reference

• src/server.ts:53-85 (registration)

  Registers the 'get_eve_wiki_article' tool using server.addTool, including name, description, input schema, and inline handler function.

  server.addTool({
    annotations: {
      openWorldHint: true,
      readOnlyHint: true,
      title: "Get EVE University Wiki Article",
    },
    description: "Get the full content of an EVE University Wiki article (with Wayback Machine fallback)",
    execute: async (args) => {
      try {
        const article = await eveWikiClient.getArticle(args.title);
        const isArchived = article.pageid === -1;
        
        return JSON.stringify(
          {
            content: article.content, // Full content without limit
            pageid: article.pageid,
            timestamp: article.timestamp,
            title: article.title,
            source: isArchived ? "wayback_machine" : "live_wiki",
            note: isArchived ? "Content retrieved from Internet Archive Wayback Machine" : undefined,
          },
          null,
          2,
        );
      } catch (error) {
        return `Error getting article: ${error}`;
      }
    },
    name: "get_eve_wiki_article",
    parameters: z.object({
      title: z.string().describe("Title of the EVE University Wiki article"),
    }),
  });

• src/server.ts:60-80 (handler)

  The tool's execute handler: fetches article via EveWikiClient, determines source (live or archived), formats and returns JSON response.

  execute: async (args) => {
    try {
      const article = await eveWikiClient.getArticle(args.title);
      const isArchived = article.pageid === -1;
      
      return JSON.stringify(
        {
          content: article.content, // Full content without limit
          pageid: article.pageid,
          timestamp: article.timestamp,
          title: article.title,
          source: isArchived ? "wayback_machine" : "live_wiki",
          note: isArchived ? "Content retrieved from Internet Archive Wayback Machine" : undefined,
        },
        null,
        2,
      );
    } catch (error) {
      return `Error getting article: ${error}`;
    }
  },

• src/server.ts:82-84 (schema)

  Zod input schema defining the 'title' parameter.

  parameters: z.object({
    title: z.string().describe("Title of the EVE University Wiki article"),
  }),

• src/eve-wiki-client.ts:161-221 (helper)

  Core implementation in EveWikiClient.getArticle: queries MediaWiki API for article content, falls back to Wayback Machine HTML scraping if unavailable.

  async getArticle(title: string): Promise<Article> {
    return this.retryableRequest(async () => {
      try {
        const response = await this.client.get("", {
          params: {
            action: "query",
            format: "json",
            prop: "revisions",
            rvprop: "content|timestamp|ids",
            rvslots: "main",
            titles: title,
          },
        });
  
        const pages = response.data?.query?.pages;
        if (!pages) {
          throw new Error("No pages found");
        }
  
        const pageId = Object.keys(pages)[0];
        const page = pages[pageId];
  
        if (page.missing) {
          throw new Error(`Article "${title}" not found`);
        }
  
        const revision = page.revisions?.[0];
        if (!revision) {
          throw new Error("No revision found");
        }
  
        return {
          content: revision.slots?.main?.["*"] || "",
          pageid: page.pageid,
          revid: revision.revid,
          timestamp: revision.timestamp,
          title: page.title,
        };
      } catch (error) {
        console.error("Primary EVE Wiki request failed, trying Wayback Machine fallback:", error);
        
        // Try Wayback Machine fallback
        try {
          const articleUrl = `https://wiki.eveuniversity.org/wiki/${encodeURIComponent(title.replace(/ /g, '_'))}`;
          const waybackContent = await this.getWaybackContent(articleUrl);
          const textContent = this.extractTextFromHtml(waybackContent);
          
          return {
            content: textContent,
            pageid: -1, // Indicate this is from Wayback Machine
            revid: -1,
            timestamp: new Date().toISOString(),
            title: `${title} (Archived)`,
          };
        } catch (waybackError) {
          console.error("Wayback Machine fallback also failed:", waybackError);
          throw new Error(`Failed to get article "${title}" from both primary source and Wayback Machine`);
        }
      }
    });
  }

• src/eve-wiki-client.ts:4-10 (schema)

  TypeScript interface defining the structure of an Article returned by getArticle.

  export interface Article {
    content: string;
    pageid: number;
    revid: number;
    timestamp: string;
    title: string;
  }