pdf-reader-mcp

README.org

@@ -8,11 +8,12 @@ This repository provides Nix derivations for MCP (Model Context Protocol) server
 
 * Available Packages
 
-| Package                    | Description                                              | Language |
-|----------------------------+----------------------------------------------------------+----------|
-| academic-search-mcp-server | Search academic papers via Semantic Scholar and Crossref | Python   |
-| manim-mcp-server           | Execute Manim animation code and return videos           | Python   |
-| zotero-mcp                 | Connect Zotero research library with AI assistants       | Python   |
+| Package                    | Description                                              | Language   |
+|----------------------------+----------------------------------------------------------+------------|
+| academic-search-mcp-server | Search academic papers via Semantic Scholar and Crossref | Python     |
+| manim-mcp-server           | Execute Manim animation code and return videos           | Python     |
+| pdf-reader-mcp             | Production-ready PDF processing with parallel processing | TypeScript |
+| zotero-mcp                 | Connect Zotero research library with AI assistants       | Python     |
 
 * Usage
 
@@ -236,7 +237,7 @@ buildGoModule rec {
 }
 #+end_src
 
-*** Node.js
+*** Node.js (with package-lock.json)
 
 #+begin_src nix
 { lib, buildNpmPackage, fetchFromGitHub }:
@@ -265,6 +266,42 @@ buildNpmPackage rec {
 }
 #+end_src
 
+*** Node.js (wrapper for npm packages without package-lock.json)
+
+Use this approach when the upstream project uses bun.lock or yarn.lock instead of package-lock.json:
+
+#+begin_src nix
+{ lib, stdenvNoCC, nodejs_22, makeWrapper }:
+
+stdenvNoCC.mkDerivation rec {
+  pname = "example-mcp-server";
+  version = "1.0.0";
+
+  # No source needed - npx fetches the package
+  dontUnpack = true;
+
+  nativeBuildInputs = [ makeWrapper ];
+
+  installPhase = ''
+    runHook preInstall
+    mkdir -p $out/bin
+    makeWrapper ${nodejs_22}/bin/npx $out/bin/${pname} \
+      --add-flags "--yes" \
+      --add-flags "@scope/package-name@${version}"
+    runHook postInstall
+  '';
+
+  meta = with lib; {
+    description = "Description";
+    homepage = "https://github.com/owner/repo";
+    license = licenses.mit;
+    mainProgram = pname;
+  };
+}
+#+end_src
+
+Note: This approach requires network access on first run as npx downloads the package.
+
 ** Calculating Hashes
 
 When adding a new package, use =lib.fakeHash= initially: