Typst Universe MCP Server

Instructions

Implementation Reference

• src/scraper.ts:237-268 (handler)

  The core handler function that scrapes the Typst Universe homepage using Cheerio to extract featured packages, parses name, version, description from links, removes duplicates, and returns TypstPackage[].

  export async function getFeaturedPackages(): Promise<TypstPackage[]> {
      const html = await fetchPage(UNIVERSE_URL);
      const $ = cheerio.load(html);
  
      const packages: TypstPackage[] = [];
  
      // Featured packages are typically at the top of the main page
      $('a[href^="/universe/package/"]').slice(0, 20).each((_, element) => {
          const $el = $(element);
          const href = $el.attr('href');
  
          if (!href) return;
  
          const text = $el.text().trim();
          const match = text.match(/^([a-z0-9_-]+)(\d+\.\d+\.\d+)(.*)$/i);
  
          if (match) {
              const [, name, version, description] = match;
              packages.push({
                  name: name.trim(),
                  version: version.trim(),
                  description: description.trim(),
                  url: `${BASE_URL}${href}`,
              });
          }
      });
  
      // Remove duplicates
      return packages.filter((pkg, index, self) =>
          index === self.findIndex(p => p.name === pkg.name)
      );
  }

• src/index.ts:72-79 (registration)

  Tool registration in the TOOLS array: defines name, description, and empty inputSchema (no parameters). This is returned by listTools.

  {
      name: 'get_featured_packages',
      description: 'Get a list of featured/popular packages from Typst Universe.',
      inputSchema: {
          type: 'object',
          properties: {},
      },
  },

• src/index.ts:254-277 (handler)

  MCP server request handler for tool calls: specifically the switch case that executes getFeaturedPackages(), handles empty results, formats output with formatPackage, and constructs the response content.

  case 'get_featured_packages': {
      const packages = await getFeaturedPackages();
  
      if (packages.length === 0) {
          return {
              content: [
                  {
                      type: 'text',
                      text: 'No featured packages found.',
                  },
              ],
          };
      }
  
      const formattedResults = packages.map(formatPackage).join('\n\n');
      return {
          content: [
              {
                  type: 'text',
                  text: `Featured packages (${packages.length}):\n\n${formattedResults}`,
              },
          ],
      };
  }

• src/scraper.ts:6-11 (schema)

  TypeScript interface defining the structure of a TypstPackage, used as input to formatPackage and output type of getFeaturedPackages.

  export interface TypstPackage {
      name: string;
      version: string;
      description: string;
      url: string;
  }

• src/index.ts:97-99 (helper)

  Utility function to format a single TypstPackage into a readable string for inclusion in the tool response.

  function formatPackage(pkg: TypstPackage): string {
      return `📦 ${pkg.name} v${pkg.version}\n   ${pkg.description}\n   URL: ${pkg.url}`;
  }