Function createServer

examples/pdf-server/server.ts:1273–2943

(options: CreateServerOptions = {})

let cachedAppHtml: string | undefined;

export function createServer(options: CreateServerOptions = {}): McpServer {
  const { enableInteract = false, useClientRoots = false } = options;
  const debug = options.debug ?? false;
  const disableInteract = !enableInteract;
  const server = new McpServer({ name: "PDF Server", version: "2.0.0" });

  if (useClientRoots) {
    // Fetch roots on initialization and subscribe to changes
    server.server.oninitialized = () => {
      refreshRoots(server.server);
    };
    server.server.setNotificationHandler(
      RootsListChangedNotificationSchema,
      async () => {
        await refreshRoots(server.server);
      },
    );
  }

  const { readPdfRange } = sharedPdfCache;

  // Tool: list_pdfs - List available PDFs
  server.tool(
    "list_pdfs",
    "List available PDFs that can be displayed",
    {},
    async (): Promise<CallToolResult> => {
      const seen = new Set<string>();
      const localFiles: string[] = [];
      const addLocal = (filePath: string) => {
        const url = pathToFileUrl(filePath);
        if (seen.has(url)) return;
        seen.add(url);
        localFiles.push(url);
      };

      // Explicitly registered files (CLI args + file roots)
      for (const filePath of allowedLocalFiles) addLocal(filePath);

      // Walk directory roots for *.pdf files
      const WALK_MAX_DEPTH = 8;
      const WALK_MAX_FILES = 500;
      let truncated = false;
      const walk = async (dir: string, depth: number): Promise<void> => {
        if (depth > WALK_MAX_DEPTH || localFiles.length >= WALK_MAX_FILES) {
          truncated ||= localFiles.length >= WALK_MAX_FILES;
          return;
        }
        let entries;
        try {
          entries = await fs.promises.readdir(dir, { withFileTypes: true });
        } catch {
          return; // unreadable — skip silently
        }
        for (const e of entries) {
          if (localFiles.length >= WALK_MAX_FILES) {
            truncated = true;
            return;