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)
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
Two Core Usage Modes
- Remote MCP over HTTP (recommended)
- Local MCP via
npx
1) Remote (Recommended)
Use this endpoint directly:
https://simple-dynamsoft-mcp.wonderfulwave-69908b91.eastus2.azurecontainerapps.io/mcp
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 guidancesearch-- semantic search across docs and samples (also accepts exact sample IDs); returnsdoc://andsample://linksread_document-- read the full text (title, public docs URL, body) of adoc://URI returned bysearchlist_samples-- browse available samples for a product/edition/platformresolve_version-- resolve current version for a product/edition/platformget_quickstart-- opinionated quickstart: picks a sample by scenario, returns code + install instructionsget_sample_files-- get full project files for a known sample (discovered via list_samples or search)
Typical doc Q&A flow: search -> 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.
Advanced Configuration And Operator Docs
Advanced settings, CI/runbook details, and maintenance workflows live in:
AGENTS.md.env.example
License
MIT
