Skip to main content
Glama
simple-dynamsoft-mcp

simple-dynamsoft-mcp

by yushulx

Dynamsoft MCP Server

MCP server that helps AI assistants generate accurate code and guidance for Dynamsoft SDKs.

Supported products:

  • Dynamic Web TWAIN (DWT)

  • Dynamsoft Document Viewer (DDV)

  • Dynamsoft Barcode Reader (DBR): mobile, web, server/desktop

  • Dynamsoft MRZ Scanner (MRZ)

  • Dynamsoft Mobile Scanner (MDS)

  • Dynamsoft Batch Barcode Scanner (BBS): Android/iOS app (documentation only, no SDK)

Default transport is stdio. Native Streamable HTTP is also supported at /mcp.

Demo Video

https://github.com/user-attachments/assets/cc1c5f4b-1461-4462-897a-75abc20d62a6

Related MCP server: Dedalus MCP Documentation Server

Two Core Usage Modes

  1. Remote MCP over HTTP (recommended)

  2. Local MCP via npx

Use this endpoint directly:

  • https://simple-dynamsoft-mcp.wonderfulwave-69908b91.eastus2.azurecontainerapps.io/mcp

Clients that cannot relay code to their users (for example a website chat widget) can connect to /mcp?delivery=links, or send the header X-Sample-Delivery: links. That connection gets documentation and GitHub sample links in place of code: tool results and resources omit code blocks (short install commands are kept as plain lines), search returns links without matched snippets or passages, get_sample_files returns only the Source link and file list, and sample:// resources return their Source link. Other connections to the same server are unaffected.

2) Local

npx -y simple-dynamsoft-mcp@latest

Deployment Guides

  • Azure Container Apps runbook: docs/deployment/azure-container-apps.md

  • Self-hosting (Ubuntu/any server): docs/deployment/self-hosting.md

MCP Client Configuration

Use one of the following client configs. Remote is recommended.

OpenCode

Remote (recommended):

Location:

  • macOS: ~/.config/opencode/opencode.json

  • Windows: %USERPROFILE%\.config\opencode\opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dynamsoft": {
      "type": "remote",
      "url": "https://simple-dynamsoft-mcp.wonderfulwave-69908b91.eastus2.azurecontainerapps.io/mcp"
    }
  }
}

Local:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dynamsoft": {
      "type": "local",
      "command": ["npx", "-y", "simple-dynamsoft-mcp@latest"]
    }
  }
}

Claude Desktop

Location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Remote (recommended):

{
  "mcpServers": {
    "dynamsoft": {
      "url": "https://simple-dynamsoft-mcp.wonderfulwave-69908b91.eastus2.azurecontainerapps.io/mcp"
    }
  }
}

Local:

{
  "mcpServers": {
    "dynamsoft": {
      "command": "npx",
      "args": ["-y", "simple-dynamsoft-mcp@latest"]
    }
  }
}

VS Code with GitHub Copilot

Global location:

  • macOS: ~/Library/Application Support/Code/User/mcp.json

  • Windows: %APPDATA%\Code\User\mcp.json

Workspace alternative: .vscode/mcp.json

Remote (recommended):

{
  "servers": {
    "dynamsoft": {
      "url": "https://simple-dynamsoft-mcp.wonderfulwave-69908b91.eastus2.azurecontainerapps.io/mcp"
    }
  }
}

Local:

{
  "servers": {
    "dynamsoft": {
      "command": "npx",
      "args": ["-y", "simple-dynamsoft-mcp@latest"]
    }
  }
}

Cursor

Location:

  • macOS: ~/.cursor/mcp.json

  • Windows: %USERPROFILE%\.cursor\mcp.json

Remote (recommended):

{
  "mcpServers": {
    "dynamsoft": {
      "url": "https://simple-dynamsoft-mcp.wonderfulwave-69908b91.eastus2.azurecontainerapps.io/mcp"
    }
  }
}

Local:

{
  "mcpServers": {
    "dynamsoft": {
      "command": "npx",
      "args": ["-y", "simple-dynamsoft-mcp@latest"]
    }
  }
}

Windsurf

Location:

  • macOS: ~/.codeium/windsurf/mcp_config.json

  • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

Remote (recommended):

{
  "mcpServers": {
    "dynamsoft": {
      "url": "https://simple-dynamsoft-mcp.wonderfulwave-69908b91.eastus2.azurecontainerapps.io/mcp"
    }
  }
}

Local:

{
  "mcpServers": {
    "dynamsoft": {
      "command": "npx",
      "args": ["-y", "simple-dynamsoft-mcp@latest"]
    }
  }
}

Cline

Location:

  • VS Code settings JSON for Cline MCP integration

Remote (recommended):

{
  "mcpServers": {
    "dynamsoft": {
      "url": "https://simple-dynamsoft-mcp.wonderfulwave-69908b91.eastus2.azurecontainerapps.io/mcp"
    }
  }
}

Local:

{
  "mcpServers": {
    "dynamsoft": {
      "command": "npx",
      "args": ["-y", "simple-dynamsoft-mcp@latest"]
    }
  }
}

Continue

Location:

  • ~/.continue/config.yaml (or workspace Continue config)

Remote (recommended):

mcpServers:
  dynamsoft:
    transport: streamable-http
    url: https://simple-dynamsoft-mcp.wonderfulwave-69908b91.eastus2.azurecontainerapps.io/mcp

Local:

mcpServers:
  dynamsoft:
    command: npx
    args:
      - -y
      - simple-dynamsoft-mcp@latest

Available Tools

The server exposes this minimal tool surface:

  • get_index -- compact product/version/sample index with selection guidance, known capability facts (OCR, VIN, ID documents, batch scanning), and productSelection.guideUri pointing to the full product-selection guide

  • search -- semantic search across docs and samples (also accepts exact sample IDs); returns doc:// and sample:// links plus the matched passage (up to ~1500 chars) of the top 3 results (content: "none" returns links and short snippets only). Sample hits include their public GitHub source URL. Without edition/platform, MRZ and MDS search their web edition, and a DBR query that names exactly one edition (for example "web app" or "Android") searches that edition and says so

  • read_document -- read the full text (title, public docs URL, body) of a doc:// URI returned by search or get_index

  • list_samples -- browse available samples for a product/edition/platform, each with its sample:// URI and public GitHub source_url

  • resolve_version -- resolve current version for a product/edition/platform

  • get_quickstart -- opinionated quickstart: picks a sample by scenario, returns its GitHub source link, install instructions, and code

  • get_sample_files -- get full project files for a known sample (discovered via list_samples or search), led by a Source: line with the sample's GitHub URL (manifest_only: true returns the link and file list without contents)

BBS is a ready-made Android/iOS app, not an SDK: search and read_document serve its documentation, while list_samples, get_quickstart, and get_sample_files return its docs and integration links instead of code.

Typical doc Q&A flow: search -> answer from a matched passage when it covers the question, otherwise read_document with the exact doc:// URI -> answer from the returned text and cite its public URL. Clients that support MCP resources can also fetch the same doc:// / sample:// URIs with resources/read.

Typical product-selection flow: get_index -> read_document with productSelection.guideUri (doc://product-selection) -> recommend from the guide's workflow questions, requirement-to-product table, driver license and VIN rules, and discovery questions.

DBR searches also cover the shared Capture Vision API pages that the DBR docs link to (for example CaptureVisionRouter.capture() and getSimplifiedSettings()/updateSettings()); these hits keep their official capture-vision/docs URL and are labelled shared Capture Vision API used by DBR in search results. Doc URIs are path-based (doc://dbr/web/web/<version>/user-guide/use-in-framework) and change only when the docs move or the SDK version changes.

Advanced Configuration And Operator Docs

Advanced settings, CI/runbook details, and maintenance workflows live in:

  • AGENTS.md

  • .env.example

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers