simple-dynamsoft-mcp 7.2.8 → 7.3.0

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

@@ -28,8 +28,8 @@
       "branch": "main",
       "owner": "dynamsoft-docs",
       "repo": "barcode-reader-docs-server",
-      "commit": "5479d530342edc40d1602addebbb8cd60ed781ce",
-      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/barcode-reader-docs-server/zip/5479d530342edc40d1602addebbb8cd60ed781ce"
+      "commit": "bd73f570f60885da04c883241d282fa3f50b45de",
+      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/barcode-reader-docs-server/zip/bd73f570f60885da04c883241d282fa3f50b45de"
     },
     {
       "name": "data/documentation/capture-vision-docs",
@@ -48,8 +48,8 @@
       "branch": "main",
       "owner": "dynamsoft-docs",
       "repo": "capture-vision-docs-js",
-      "commit": "3137b83d966e795190a9681e544045a5e526c083",
-      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/capture-vision-docs-js/zip/3137b83d966e795190a9681e544045a5e526c083"
+      "commit": "0e1fbd5338505a8bbfc3310eb3c3fffe6a114cf5",
+      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/capture-vision-docs-js/zip/0e1fbd5338505a8bbfc3310eb3c3fffe6a114cf5"
     },
     {
       "name": "data/documentation/capture-vision-docs-mobile",
@@ -68,8 +68,8 @@
       "branch": "main",
       "owner": "dynamsoft-docs",
       "repo": "capture-vision-docs-server",
-      "commit": "f20caf7c96383a04659bdffe8ab40b85ba78d39d",
-      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/capture-vision-docs-server/zip/f20caf7c96383a04659bdffe8ab40b85ba78d39d"
+      "commit": "d097a606f81cc2a3af5c813200715ed943009f5e",
+      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/capture-vision-docs-server/zip/d097a606f81cc2a3af5c813200715ed943009f5e"
     },
     {
       "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",
@@ -278,8 +308,8 @@
       "branch": "main",
       "owner": "Dynamsoft",
       "repo": "capture-vision-python-samples",
-      "commit": "8fdf4c63d5e35bdcc4993a068ba4bcade30e91a2",
-      "archiveUrl": "https://codeload.github.com/Dynamsoft/capture-vision-python-samples/zip/8fdf4c63d5e35bdcc4993a068ba4bcade30e91a2"
+      "commit": "734203cfe5d7113b6c406e5305db6696bab0792c",
+      "archiveUrl": "https://codeload.github.com/Dynamsoft/capture-vision-python-samples/zip/734203cfe5d7113b6c406e5305db6696bab0792c"
     },
     {
       "name": "data/samples/dynamsoft-capture-vision-react-native",
@@ -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/data/metadata/dynamsoft_sdks.json

@@ -120,7 +120,7 @@
     "dbr-server": {
       "name": "Dynamsoft Barcode Reader Server/Desktop SDK",
       "description": "Barcode scanning for server/desktop platforms including Python, .NET, Java, C++, and Node.js.",
-      "version": "11.4.1000",
+      "version": "11.4.2000",
       "default_platform": "python",
       "snippet_path": "dynamsoft-barcode-reader/server",
       "platforms": {
@@ -255,7 +255,7 @@
     "dcv-core": {
       "name": "Dynamsoft Capture Vision Core",
       "description": "Unified architecture documentation for Capture Vision capabilities across barcode, MRZ, document normalization, and parsing workflows.",
-      "version": "3.4.1000",
+      "version": "3.4.2000",
       "default_platform": "core",
       "snippet_path": "dynamsoft-capture-vision/core",
       "platforms": {
@@ -270,7 +270,7 @@
     "dcv-server": {
       "name": "Dynamsoft Capture Vision Server/Desktop SDK",
       "description": "Capture Vision workflows for Python, .NET, Java, C++, and Node.js, including VIN, MRZ, document normalization, and driver license scenarios.",
-      "version": "3.4.1000",
+      "version": "3.4.2000",
       "default_platform": "python",
       "snippet_path": "dynamsoft-capture-vision/server",
       "platforms": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simple-dynamsoft-mcp",
-  "version": "7.2.8",
+  "version": "7.3.0",
   "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
+};