simple-dynamsoft-mcp 7.2.9 → 7.3.1

package/README.md

@@ -3,10 +3,11 @@
 MCP server that helps AI assistants generate accurate code and guidance for Dynamsoft SDKs.
 
 Supported products:
-- Dynamsoft Capture Vision (DCV)
-- Dynamsoft Barcode Reader (DBR): mobile, web, server/desktop
 - Dynamic Web TWAIN (DWT)
 - Dynamsoft Document Viewer (DDV)
+- Dynamsoft Barcode Reader (DBR): mobile, web, server/desktop
+- Dynamsoft MRZ Scanner (MRZ)
+- Dynamsoft Mobile Scanner (MDS)
 
 Default transport is `stdio`. Native Streamable HTTP is also supported at `/mcp`.
 

package/data/metadata/data-manifest.json

@@ -18,8 +18,8 @@
       "branch": "main",
       "owner": "dynamsoft-docs",
       "repo": "barcode-reader-docs-mobile",
-      "commit": "e0308b08e0b235093b29af187839835e0e4b7c20",
-      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/barcode-reader-docs-mobile/zip/e0308b08e0b235093b29af187839835e0e4b7c20"
+      "commit": "73e2ec43e875e093367b385f167e021f47f2ee1b",
+      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/barcode-reader-docs-mobile/zip/73e2ec43e875e093367b385f167e021f47f2ee1b"
     },
     {
       "name": "data/documentation/barcode-reader-docs-server",
@@ -28,8 +28,8 @@
       "branch": "main",
       "owner": "dynamsoft-docs",
       "repo": "barcode-reader-docs-server",
-      "commit": "bd73f570f60885da04c883241d282fa3f50b45de",
-      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/barcode-reader-docs-server/zip/bd73f570f60885da04c883241d282fa3f50b45de"
+      "commit": "2a786507c616bc82e79e626f6d03f6b67bf93059",
+      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/barcode-reader-docs-server/zip/2a786507c616bc82e79e626f6d03f6b67bf93059"
     },
     {
       "name": "data/documentation/capture-vision-docs",
@@ -48,8 +48,8 @@
       "branch": "main",
       "owner": "dynamsoft-docs",
       "repo": "capture-vision-docs-js",
-      "commit": "0e1fbd5338505a8bbfc3310eb3c3fffe6a114cf5",
-      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/capture-vision-docs-js/zip/0e1fbd5338505a8bbfc3310eb3c3fffe6a114cf5"
+      "commit": "e0a78b0bbe850feacac32c93ccc9f362ea7f2e2d",
+      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/capture-vision-docs-js/zip/e0a78b0bbe850feacac32c93ccc9f362ea7f2e2d"
     },
     {
       "name": "data/documentation/capture-vision-docs-mobile",
@@ -58,8 +58,8 @@
       "branch": "main",
       "owner": "dynamsoft-docs",
       "repo": "capture-vision-docs-mobile",
-      "commit": "618991bac7908e65aeb4669bcd2dd0f57c84bca3",
-      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/capture-vision-docs-mobile/zip/618991bac7908e65aeb4669bcd2dd0f57c84bca3"
+      "commit": "06b8b0009ae72427dc63d4a2b58491c5fc74ed70",
+      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/capture-vision-docs-mobile/zip/06b8b0009ae72427dc63d4a2b58491c5fc74ed70"
     },
     {
       "name": "data/documentation/capture-vision-docs-server",
@@ -68,8 +68,8 @@
       "branch": "main",
       "owner": "dynamsoft-docs",
       "repo": "capture-vision-docs-server",
-      "commit": "d097a606f81cc2a3af5c813200715ed943009f5e",
-      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/capture-vision-docs-server/zip/d097a606f81cc2a3af5c813200715ed943009f5e"
+      "commit": "f4653d3b7a5fa7e6706a3e848f676ed06f696685",
+      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/capture-vision-docs-server/zip/f4653d3b7a5fa7e6706a3e848f676ed06f696685"
     },
     {
       "name": "data/documentation/document-viewer-docs",
@@ -81,6 +81,26 @@
       "commit": "b187c4d36884df285d02dfb977e450e53f097d51",
       "archiveUrl": "https://codeload.github.com/dynamsoft-docs/document-viewer-docs/zip/b187c4d36884df285d02dfb977e450e53f097d51"
     },
+    {
+      "name": "data/documentation/mobile-document-scanner-docs-js",
+      "path": "documentation/mobile-document-scanner-docs-js",
+      "url": "https://github.com/dynamsoft-docs/mobile-document-scanner-docs-js.git",
+      "branch": "main",
+      "owner": "dynamsoft-docs",
+      "repo": "mobile-document-scanner-docs-js",
+      "commit": "ebef2d269a114ac7763a6c0635d098a09cdcbf59",
+      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/mobile-document-scanner-docs-js/zip/ebef2d269a114ac7763a6c0635d098a09cdcbf59"
+    },
+    {
+      "name": "data/documentation/mrz-scanner-docs-js",
+      "path": "documentation/mrz-scanner-docs-js",
+      "url": "https://github.com/dynamsoft-docs/mrz-scanner-docs-js.git",
+      "branch": "main",
+      "owner": "dynamsoft-docs",
+      "repo": "mrz-scanner-docs-js",
+      "commit": "9a4a8914a3c20f10267e5947c27e33264767f342",
+      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/mrz-scanner-docs-js/zip/9a4a8914a3c20f10267e5947c27e33264767f342"
+    },
     {
       "name": "data/documentation/web-twain-docs",
       "path": "documentation/web-twain-docs",
@@ -91,6 +111,16 @@
       "commit": "7b8e127b298a2ef9abb7cd870bb742b44a132503",
       "archiveUrl": "https://codeload.github.com/dynamsoft-docs/web-twain-docs/zip/7b8e127b298a2ef9abb7cd870bb742b44a132503"
     },
+    {
+      "name": "data/samples/document-scanner-javascript",
+      "path": "samples/document-scanner-javascript",
+      "url": "https://github.com/Dynamsoft/document-scanner-javascript.git",
+      "branch": "main",
+      "owner": "Dynamsoft",
+      "repo": "document-scanner-javascript",
+      "commit": "af8d65b104ffef6f846b64fc2598baaa2a6ff6ea",
+      "archiveUrl": "https://codeload.github.com/Dynamsoft/document-scanner-javascript/zip/af8d65b104ffef6f846b64fc2598baaa2a6ff6ea"
+    },
     {
       "name": "data/samples/dynamic-web-twain",
       "path": "samples/dynamic-web-twain",
@@ -118,8 +148,8 @@
       "branch": "main",
       "owner": "Dynamsoft",
       "repo": "barcode-reader-c-cpp-samples",
-      "commit": "31193773be1b64616d84a0ac439dde1a1e1d3067",
-      "archiveUrl": "https://codeload.github.com/Dynamsoft/barcode-reader-c-cpp-samples/zip/31193773be1b64616d84a0ac439dde1a1e1d3067"
+      "commit": "3af2b7b60342e97b8f91ef803ea26e777bb4b4dd",
+      "archiveUrl": "https://codeload.github.com/Dynamsoft/barcode-reader-c-cpp-samples/zip/3af2b7b60342e97b8f91ef803ea26e777bb4b4dd"
     },
     {
       "name": "data/samples/dynamsoft-barcode-reader-dotnet",
@@ -128,8 +158,8 @@
       "branch": "main",
       "owner": "Dynamsoft",
       "repo": "barcode-reader-dotnet-samples",
-      "commit": "5d7abad2ba3a23bff70ccbd8359f47ebb8605953",
-      "archiveUrl": "https://codeload.github.com/Dynamsoft/barcode-reader-dotnet-samples/zip/5d7abad2ba3a23bff70ccbd8359f47ebb8605953"
+      "commit": "e1779bb6996510225bb7e3adac365b3bed688be2",
+      "archiveUrl": "https://codeload.github.com/Dynamsoft/barcode-reader-dotnet-samples/zip/e1779bb6996510225bb7e3adac365b3bed688be2"
     },
     {
       "name": "data/samples/dynamsoft-barcode-reader-flutter",
@@ -148,8 +178,8 @@
       "branch": "main",
       "owner": "Dynamsoft",
       "repo": "barcode-reader-java-samples",
-      "commit": "16cc16f9e0c8625842a43d6bdd1474720976ecd7",
-      "archiveUrl": "https://codeload.github.com/Dynamsoft/barcode-reader-java-samples/zip/16cc16f9e0c8625842a43d6bdd1474720976ecd7"
+      "commit": "c3f164a5eefd795ae2a7bb0cd8dacb70db7450b2",
+      "archiveUrl": "https://codeload.github.com/Dynamsoft/barcode-reader-java-samples/zip/c3f164a5eefd795ae2a7bb0cd8dacb70db7450b2"
     },
     {
       "name": "data/samples/dynamsoft-barcode-reader-maui",
@@ -188,8 +218,8 @@
       "branch": "main",
       "owner": "Dynamsoft",
       "repo": "barcode-reader-react-native-samples",
-      "commit": "acb3ac877853f1543ff086fb15df30335b0d4cbe",
-      "archiveUrl": "https://codeload.github.com/Dynamsoft/barcode-reader-react-native-samples/zip/acb3ac877853f1543ff086fb15df30335b0d4cbe"
+      "commit": "05c43007ec6b64221d6ffad986ed6623195cb88b",
+      "archiveUrl": "https://codeload.github.com/Dynamsoft/barcode-reader-react-native-samples/zip/05c43007ec6b64221d6ffad986ed6623195cb88b"
     },
     {
       "name": "data/samples/dynamsoft-capture-vision-c-cpp",
@@ -198,8 +228,8 @@
       "branch": "main",
       "owner": "Dynamsoft",
       "repo": "capture-vision-cpp-samples",
-      "commit": "6d37fa7f16bc84cbd2b78651549cb900cf222571",
-      "archiveUrl": "https://codeload.github.com/Dynamsoft/capture-vision-cpp-samples/zip/6d37fa7f16bc84cbd2b78651549cb900cf222571"
+      "commit": "dc2f6f21579591b95b6d5251066cb0094fa4ce74",
+      "archiveUrl": "https://codeload.github.com/Dynamsoft/capture-vision-cpp-samples/zip/dc2f6f21579591b95b6d5251066cb0094fa4ce74"
     },
     {
       "name": "data/samples/dynamsoft-capture-vision-dotnet",
@@ -208,8 +238,8 @@
       "branch": "main",
       "owner": "Dynamsoft",
       "repo": "capture-vision-dotnet-samples",
-      "commit": "1ac2d63ea45d63ee7421725e351936ca5c321ce2",
-      "archiveUrl": "https://codeload.github.com/Dynamsoft/capture-vision-dotnet-samples/zip/1ac2d63ea45d63ee7421725e351936ca5c321ce2"
+      "commit": "1c6d1f3dbdcc11192b83498f5dca01fd192ee26a",
+      "archiveUrl": "https://codeload.github.com/Dynamsoft/capture-vision-dotnet-samples/zip/1c6d1f3dbdcc11192b83498f5dca01fd192ee26a"
     },
     {
       "name": "data/samples/dynamsoft-capture-vision-flutter",
@@ -228,8 +258,8 @@
       "branch": "main",
       "owner": "Dynamsoft",
       "repo": "capture-vision-java-samples",
-      "commit": "974c436210232a8579fc68b98f610c9d46e86979",
-      "archiveUrl": "https://codeload.github.com/Dynamsoft/capture-vision-java-samples/zip/974c436210232a8579fc68b98f610c9d46e86979"
+      "commit": "ad9d5516cdae5d1240966271896f6f13e6ae5476",
+      "archiveUrl": "https://codeload.github.com/Dynamsoft/capture-vision-java-samples/zip/ad9d5516cdae5d1240966271896f6f13e6ae5476"
     },
     {
       "name": "data/samples/dynamsoft-capture-vision-javascript",
@@ -288,8 +318,8 @@
       "branch": "main",
       "owner": "Dynamsoft",
       "repo": "capture-vision-react-native-samples",
-      "commit": "c00158c5f3be2716a391d2f6f1412f9c8a2ac52f",
-      "archiveUrl": "https://codeload.github.com/Dynamsoft/capture-vision-react-native-samples/zip/c00158c5f3be2716a391d2f6f1412f9c8a2ac52f"
+      "commit": "e27f4e6708f4eb8570893bf36399cc02b6f7759f",
+      "archiveUrl": "https://codeload.github.com/Dynamsoft/capture-vision-react-native-samples/zip/e27f4e6708f4eb8570893bf36399cc02b6f7759f"
     },
     {
       "name": "data/samples/dynamsoft-capture-vision-spm",
@@ -310,6 +340,16 @@
       "repo": "document-viewer-samples",
       "commit": "84fbb0ce71aa4d327aeeb39dab57cab92c43cd9d",
       "archiveUrl": "https://codeload.github.com/Dynamsoft/document-viewer-samples/zip/84fbb0ce71aa4d327aeeb39dab57cab92c43cd9d"
+    },
+    {
+      "name": "data/samples/mrz-scanner-javascript",
+      "path": "samples/mrz-scanner-javascript",
+      "url": "https://github.com/Dynamsoft/mrz-scanner-javascript.git",
+      "branch": "main",
+      "owner": "Dynamsoft",
+      "repo": "mrz-scanner-javascript",
+      "commit": "1e33685573dafa918bc81a7baa9fc628e3830775",
+      "archiveUrl": "https://codeload.github.com/Dynamsoft/mrz-scanner-javascript/zip/1e33685573dafa918bc81a7baa9fc628e3830775"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simple-dynamsoft-mcp",
-  "version": "7.2.9",
+  "version": "7.3.1",
   "description": "MCP server for Dynamsoft SDKs - Capture Vision, Barcode Reader (Mobile/Python/Web), Dynamic Web TWAIN, and Document Viewer. Provides documentation, code snippets, and API guidance.",
   "license": "MIT",
   "repository": {

package/src/data/repo-map.js

@@ -1,4 +1,5 @@
 import { normalizeHydrationScopes } from "./hydration-policy.js";
+import { getHydrationProduct } from "../server/public-offerings.js";
 
 const REPO_MAP = {
   dbr: {
@@ -85,6 +86,39 @@ const REPO_MAP = {
       ]
     }
   },
+  mrz: {
+    docs: {
+      web: ["documentation/mrz-scanner-docs-js"],
+      any: [
+        "documentation/mrz-scanner-docs-js",
+        "documentation/capture-vision-docs-mobile"
+      ]
+    },
+    samples: {
+      web: ["samples/mrz-scanner-javascript"],
+      mobile: [
+        "samples/dynamsoft-capture-vision-react-native",
+        "samples/dynamsoft-capture-vision-flutter",
+        "samples/dynamsoft-capture-vision-mobile"
+      ],
+      any: [
+        "samples/mrz-scanner-javascript",
+        "samples/dynamsoft-capture-vision-react-native",
+        "samples/dynamsoft-capture-vision-flutter",
+        "samples/dynamsoft-capture-vision-mobile"
+      ]
+    }
+  },
+  mds: {
+    docs: {
+      web: ["documentation/mobile-document-scanner-docs-js"],
+      any: ["documentation/mobile-document-scanner-docs-js"]
+    },
+    samples: {
+      web: ["samples/document-scanner-javascript"],
+      any: ["samples/document-scanner-javascript"]
+    }
+  },
   dwt: {
     docs: {
       any: ["documentation/web-twain-docs"]
@@ -129,12 +163,18 @@ function resolveRepoPathsForScopes(scopes = [], manifest = null) {
     const includeSamples = scope.type === "any" || scope.type === "sample";
 
     if (includeDocs) {
-      for (const path of getMappedPaths(scope.product, scope.edition, "docs")) {
+      const docsPaths = getMappedPaths(scope.product, scope.edition, "docs");
+      for (const path of (docsPaths.length > 0
+        ? docsPaths
+        : getMappedPaths(getHydrationProduct(scope.product), scope.edition, "docs"))) {
         resolved.add(path);
       }
     }
     if (includeSamples) {
-      for (const path of getMappedPaths(scope.product, scope.edition, "samples")) {
+      const samplePaths = getMappedPaths(scope.product, scope.edition, "samples");
+      for (const path of (samplePaths.length > 0
+        ? samplePaths
+        : getMappedPaths(getHydrationProduct(scope.product), scope.edition, "samples"))) {
         resolved.add(path);
       }
     }

package/src/server/create-server.js

@@ -22,6 +22,8 @@ export function createMcpServerInstance({ pkgVersion, resourceIndexApi, ragApi }
     getDcvMobileSamplePath,
     getDcvServerSamplePath,
     getDcvWebSamplePath,
+    getMrzWebSamplePath,
+    getMdsWebSamplePath,
     getDwtSamplePath,
     getDdvSamplePath,
     readCodeFile,
@@ -62,7 +64,7 @@ export function createMcpServerInstance({ pkgVersion, resourceIndexApi, ragApi }
 const server = new McpServer({
   name: "simple-dynamsoft-mcp",
   version: pkgVersion,
-  description: "MCP server for latest major versions of Dynamsoft SDKs: Capture Vision, Barcode Reader, Dynamic Web TWAIN, and Document Viewer. Includes guidance for choosing DBR vs DCV by scenario."
+  description: "MCP server for the public Dynamsoft offerings: Barcode Reader, Dynamic Web TWAIN, Document Viewer, MRZ, and MDS. Includes guidance for choosing the right public product by workflow."
 });
 
 registerIndexTools({
@@ -83,6 +85,7 @@ registerIndexTools({
 
 registerSampleTools({
   server,
+  registry,
   ensureScopeHydrated,
   ensureLatestMajor,
   normalizeProduct,
@@ -148,6 +151,8 @@ registerProjectTools({
   getDcvMobileSamplePath,
   getDcvServerSamplePath,
   getDcvWebSamplePath,
+  getMrzWebSamplePath,
+  getMdsWebSamplePath,
   getDwtSamplePath,
   getDdvSamplePath,
   getSampleSuggestions

package/src/server/normalizers.js

@@ -1,3 +1,5 @@
+import { normalizePublicOffering } from "./public-offerings.js";
+
 const sdkAliases = {
   // DCV
   "dcv": "dcv-mobile",
@@ -94,6 +96,7 @@ const platformAliases = {
   reactjs: "react",
   "react.js": "react",
   "react-vite": "react",
+  "react-hooks": "react",
   vue: "vue",
   vuejs: "vue",
   next: "next",
@@ -113,7 +116,7 @@ const platformAliases = {
 
 const SERVER_PLATFORMS = new Set(["python", "cpp", "java", "dotnet", "nodejs"]);
 const WEB_FRAMEWORK_TAG_ALIASES = {
-  react: ["react", "react-vite"]
+  react: ["react", "react-vite", "react-hooks"]
 };
 
 const languageAliases = {
@@ -234,6 +237,9 @@ function normalizeSampleName(name) {
 function normalizeProduct(product) {
   if (!product) return "";
   const normalized = product.trim().toLowerCase();
+  const publicOffering = normalizePublicOffering(normalized);
+  if (publicOffering) return publicOffering;
+
   if (
     [
       "dcv",
@@ -242,24 +248,12 @@ function normalizeProduct(product) {
       "dynamsoft capture vision",
       "dynamsoft capture vision sdk",
       "capture vision bundle",
-      "mrz scanner",
       "vin scanner",
-      "driver license scanner",
-      "document scanner",
-      "document normalization"
+      "driver license scanner"
     ].includes(normalized)
   ) {
     return "dcv";
   }
-  if (["ddv", "document viewer", "document-viewer", "dynamsoft document viewer", "doc viewer", "pdf viewer"].includes(normalized)) {
-    return "ddv";
-  }
-  if (["dbr", "barcode reader", "barcode-reader", "dynamsoft barcode reader"].includes(normalized)) {
-    return "dbr";
-  }
-  if (["dwt", "dynamic web twain", "web twain", "webtwain"].includes(normalized)) {
-    return "dwt";
-  }
   return normalized;
 }
 

package/src/server/public-offerings.js

@@ -0,0 +1,71 @@
+const PUBLIC_OFFERING_ALIASES = {
+  dwt: "dwt",
+  "dynamic web twain": "dwt",
+  "web twain": "dwt",
+  webtwain: "dwt",
+  twain: "dwt",
+  ddv: "ddv",
+  "document viewer": "ddv",
+  "document-viewer": "ddv",
+  "dynamsoft document viewer": "ddv",
+  "doc viewer": "ddv",
+  "pdf viewer": "ddv",
+  "edit viewer": "ddv",
+  dbr: "dbr",
+  "barcode reader": "dbr",
+  "barcode-reader": "dbr",
+  "dynamsoft barcode reader": "dbr",
+  mrz: "mrz",
+  "mrz scanner": "mrz",
+  "machine readable zone": "mrz",
+  mds: "mds",
+  "document scanner": "mds",
+  "document scanning": "mds",
+  "document scan": "mds",
+  "document normalization": "mds",
+  "document normalizer": "mds"
+};
+
+const PUBLIC_OFFERING_PRODUCTS = ["dwt", "ddv", "dbr", "mrz", "mds"];
+
+const HYDRATION_PRODUCT_MAP = {
+  mrz: "dcv",
+  mds: "dcv"
+};
+
+const PUBLIC_OFFERINGS_TEXT = "dbr, dwt, ddv, mrz, or mds";
+
+function normalizePublicOffering(product) {
+  if (!product) return "";
+  const normalized = product.trim().toLowerCase();
+  return PUBLIC_OFFERING_ALIASES[normalized] || "";
+}
+
+function getHydrationProduct(product) {
+  const normalized = normalizePublicOffering(product) || String(product || "").trim().toLowerCase();
+  return HYDRATION_PRODUCT_MAP[normalized] || normalized;
+}
+
+function isKnownPublicOffering(product) {
+  return PUBLIC_OFFERING_PRODUCTS.includes(product);
+}
+
+function buildUnknownPublicProductResponse(requestedProduct) {
+  const value = String(requestedProduct || "").trim();
+  return {
+    isError: true,
+    content: [{
+      type: "text",
+      text: `Unknown public product "${value}". Use ${PUBLIC_OFFERINGS_TEXT}.`
+    }]
+  };
+}
+
+export {
+  PUBLIC_OFFERING_PRODUCTS,
+  PUBLIC_OFFERINGS_TEXT,
+  normalizePublicOffering,
+  getHydrationProduct,
+  isKnownPublicOffering,
+  buildUnknownPublicProductResponse
+};