DocsFetcher MCP Server

MIT License
OverviewInspectSchema Related Servers Reviews Score
src
utils
import fetch from "node-fetch";

/**
 * Utility to detect if a string is a URL
 * @param str String to check
 * @returns true if the string is a valid URL
 */
export function isUrl(str: string): boolean {
  try {
    new URL(str);
    return true;
  } catch (e) {
    return false;
  }
}

/**
 * Get the npm package documentation URL
 * @param packageName Name of the npm package
 * @returns URL of the npm package page
 */
export function getNpmPackageUrl(packageName: string): string {
  return `https://www.npmjs.com/package/${packageName}`;
}

/**
 * Get package URL for different package repositories based on language
 * @param packageName Name of the package
 * @param language Programming language or repository type
 * @returns URL of the package documentation page
 */
export function getPackageUrl(
  packageName: string,
  language = "javascript"
): string {
  const lang = language.toLowerCase().trim();

  switch (lang) {
    // JavaScript/TypeScript
    case "javascript":
    case "js":
    case "typescript":
    case "ts":
    case "node":
    case "nodejs":
    case "npm":
      return `https://www.npmjs.com/package/${packageName}`;

    // Python
    case "python":
    case "py":
    case "pypi":
      return `https://pypi.org/project/${packageName}`;

    // Java
    case "java":
    case "maven":
      return `https://mvnrepository.com/artifact/${packageName}`;

    // .NET
    case "dotnet":
    case ".net":
    case "csharp":
    case "c#":
    case "nuget":
      return `https://www.nuget.org/packages/${packageName}`;

    // Ruby
    case "ruby":
    case "gem":
    case "rubygem":
    case "rubygems":
      return `https://rubygems.org/gems/${packageName}`;

    // PHP
    case "php":
    case "composer":
    case "packagist":
      return `https://packagist.org/packages/${packageName}`;

    // Rust
    case "rust":
    case "cargo":
    case "crate":
    case "crates":
      return `https://crates.io/crates/${packageName}`;

    // Go
    case "go":
    case "golang":
      return `https://pkg.go.dev/${packageName}`;

    // Swift
    case "swift":
    case "cocoapods":
      return `https://cocoapods.org/pods/${packageName}`;

    // Default to npm
    default:
      return `https://www.npmjs.com/package/${packageName}`;
  }
}

/**
 * Get the GitHub repository URL for an npm package
 * @param packageName Name of the npm package
 * @returns GitHub repository URL, or null if not found
 */
export async function getGitHubRepoUrl(
  packageName: string
): Promise<string | null> {
  try {
    const response = await fetch(`https://registry.npmjs.org/${packageName}`);
    const data = (await response.json()) as any;

    // Try to get GitHub URL from repository field
    if (
      data.repository &&
      typeof data.repository === "object" &&
      data.repository.url
    ) {
      const repoUrl = data.repository.url;
      if (repoUrl.includes("github.com")) {
        return repoUrl
          .replace("git+", "")
          .replace("git://", "https://")
          .replace(".git", "");
      }
    }

    // Try to get GitHub URL from homepage field
    if (
      data.homepage &&
      typeof data.homepage === "string" &&
      data.homepage.includes("github.com")
    ) {
      return data.homepage;
    }

    return null;
  } catch (error) {
    console.error(`Error fetching GitHub repo URL for ${packageName}:`, error);
    return null;
  }
}

/**
 * Extract library name from URL
 * @param url URL to extract library name from
 * @returns Library name
 */
export function extractLibraryName(url: string): string {
  let libraryName = url;
  if (url.includes("npmjs.com/package/")) {
    libraryName = url.split("/package/")[1].split("/")[0];
  } else if (url.includes("pypi.org/project/")) {
    libraryName = url.split("/project/")[1].split("/")[0];
  } else if (url.includes("nuget.org/packages/")) {
    libraryName = url.split("/packages/")[1].split("/")[0];
  } else if (url.includes("rubygems.org/gems/")) {
    libraryName = url.split("/gems/")[1].split("/")[0];
  } else if (url.includes("packagist.org/packages/")) {
    libraryName = url.split("/packages/")[1].split("/")[0];
  } else if (url.includes("crates.io/crates/")) {
    libraryName = url.split("/crates/")[1].split("/")[0];
  } else if (url.includes("pkg.go.dev/")) {
    libraryName = url.split("pkg.go.dev/")[1].split("/")[0];
  } else if (url.includes("cocoapods.org/pods/")) {
    libraryName = url.split("/pods/")[1].split("/")[0];
  } else if (url.includes("mvnrepository.com/artifact/")) {
    libraryName = url.split("/artifact/")[1].split("/")[0];
  } else if (url.includes("github.com")) {
    const parts = url.split("github.com/")[1].split("/");
    if (parts.length >= 2) {
      libraryName = parts[1];
    }
  }
  return libraryName;
}