getting_started

Instructions

Implementation Reference

• src/index.ts:188-212 (registration)

  Tool registration for 'getting_started' - defines the tool name, description, no parameters, and the handler that calls fetchGettingStarted() to fetch and return documentation content.

  // Tool: Get getting started / installation guide
  server.tool(
    "getting_started",
    "Get the Reacticx getting started guide with installation and setup instructions.",
    {},
    async () => {
      try {
        const docs = await fetchGettingStarted();
        return {
          content: [{ type: "text" as const, text: docs }],
        };
      } catch (error) {
        const message =
          error instanceof Error ? error.message : String(error);
        return {
          content: [
            {
              type: "text" as const,
              text: `Error fetching getting started docs: ${message}\n\nBasic installation:\n\`\`\`bash\n# Add a component\nbunx --bun reacticx add <component-name>\n\n# Common dependencies\nnpm install react-native-reanimated @shopify/react-native-skia react-native-gesture-handler\n\`\`\`\n\nDocs: https://www.reacticx.com/docs`,
            },
          ],
        };
      }
    }
  );

• src/fetcher.ts:150-185 (handler)

  The fetchGettingStarted function that implements the core logic - checks cache, fetches HTML from https://www.reacticx.com/docs, converts to markdown, caches the result, and returns formatted documentation.

  export async function fetchGettingStarted(): Promise<string> {
    const cached = cache.get("__getting_started__");
    if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
      return cached.content;
    }
  
    try {
      const response = await fetch("https://www.reacticx.com/docs", {
        headers: {
          "User-Agent": "ReacticxMCP/1.0",
          Accept: "text/html",
        },
      });
  
      if (!response.ok) {
        throw new Error(`HTTP ${response.status}`);
      }
  
      const html = await response.text();
      const markdown = htmlToMarkdown(html);
  
      const content = [
        "# Reacticx - Getting Started",
        "Source: https://www.reacticx.com/docs",
        "",
        markdown,
      ].join("\n");
  
      cache.set("__getting_started__", { content, timestamp: Date.now() });
      return content;
    } catch (error) {
      const message =
        error instanceof Error ? error.message : String(error);
      throw new Error(`Failed to fetch getting started docs: ${message}`);
    }
  }

• src/fetcher.ts:6-102 (helper)

  Helper function htmlToMarkdown that converts HTML content to markdown format by stripping tags, converting elements like headings, code blocks, links, lists, etc., and cleaning up whitespace.

  function htmlToMarkdown(html: string): string {
    let text = html;
  
    // Remove script and style tags with content
    text = text.replace(/<script[\s\S]*?<\/script>/gi, "");
    text = text.replace(/<style[\s\S]*?<\/style>/gi, "");
    text = text.replace(/<nav[\s\S]*?<\/nav>/gi, "");
    text = text.replace(/<footer[\s\S]*?<\/footer>/gi, "");
    text = text.replace(/<header[\s\S]*?<\/header>/gi, "");
  
    // Extract the main content area if possible
    const mainMatch = text.match(
      /<main[\s\S]*?>([\s\S]*?)<\/main>/i
    );
    const articleMatch = text.match(
      /<article[\s\S]*?>([\s\S]*?)<\/article>/i
    );
    if (articleMatch) {
      text = articleMatch[1];
    } else if (mainMatch) {
      text = mainMatch[1];
    }
  
    // Convert headings
    text = text.replace(/<h1[^>]*>([\s\S]*?)<\/h1>/gi, "\n# $1\n");
    text = text.replace(/<h2[^>]*>([\s\S]*?)<\/h2>/gi, "\n## $1\n");
    text = text.replace(/<h3[^>]*>([\s\S]*?)<\/h3>/gi, "\n### $1\n");
    text = text.replace(/<h4[^>]*>([\s\S]*?)<\/h4>/gi, "\n#### $1\n");
  
    // Convert code blocks - handle <pre><code> combinations
    text = text.replace(
      /<pre[^>]*>\s*<code[^>]*class="[^"]*language-(\w+)"[^>]*>([\s\S]*?)<\/code>\s*<\/pre>/gi,
      "\n```$1\n$2\n```\n"
    );
    text = text.replace(
      /<pre[^>]*>\s*<code[^>]*>([\s\S]*?)<\/code>\s*<\/pre>/gi,
      "\n```\n$1\n```\n"
    );
    text = text.replace(
      /<pre[^>]*>([\s\S]*?)<\/pre>/gi,
      "\n```\n$1\n```\n"
    );
  
    // Convert inline code
    text = text.replace(/<code[^>]*>([\s\S]*?)<\/code>/gi, "`$1`");
  
    // Convert bold and italic
    text = text.replace(/<(strong|b)[^>]*>([\s\S]*?)<\/\1>/gi, "**$2**");
    text = text.replace(/<(em|i)[^>]*>([\s\S]*?)<\/\1>/gi, "*$2*");
  
    // Convert links
    text = text.replace(
      /<a[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi,
      "[$2]($1)"
    );
  
    // Convert list items
    text = text.replace(/<li[^>]*>([\s\S]*?)<\/li>/gi, "- $1\n");
    text = text.replace(/<\/?[ou]l[^>]*>/gi, "\n");
  
    // Convert table elements
    text = text.replace(/<tr[^>]*>([\s\S]*?)<\/tr>/gi, "$1|\n");
    text = text.replace(/<th[^>]*>([\s\S]*?)<\/th>/gi, "| $1 ");
    text = text.replace(/<td[^>]*>([\s\S]*?)<\/td>/gi, "| $1 ");
    text = text.replace(/<\/?table[^>]*>/gi, "\n");
    text = text.replace(/<\/?thead[^>]*>/gi, "");
    text = text.replace(/<\/?tbody[^>]*>/gi, "");
  
    // Convert paragraphs and breaks
    text = text.replace(/<p[^>]*>([\s\S]*?)<\/p>/gi, "\n$1\n");
    text = text.replace(/<br\s*\/?>/gi, "\n");
    text = text.replace(/<hr\s*\/?>/gi, "\n---\n");
  
    // Convert divs to newlines
    text = text.replace(/<div[^>]*>/gi, "\n");
    text = text.replace(/<\/div>/gi, "\n");
  
    // Remove remaining HTML tags
    text = text.replace(/<[^>]+>/g, "");
  
    // Decode HTML entities
    text = text.replace(/&/g, "&");
    text = text.replace(/</g, "<");
    text = text.replace(/>/g, ">");
    text = text.replace(/"/g, '"');
    text = text.replace(/'/g, "'");
    text = text.replace(/ /g, " ");
    text = text.replace(/&#(\d+);/g, (_, code) =>
      String.fromCharCode(parseInt(code))
    );
  
    // Clean up whitespace
    text = text.replace(/\n{3,}/g, "\n\n");
    text = text.trim();
  
    return text;
  }