simple-dynamsoft-mcp
by yushulx
README.md
# 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
## Two Core Usage Modes
1. Remote MCP over HTTP (recommended)
2. Local MCP via `npx`
### 1) Remote (Recommended)
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
```bash
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
<details>
<summary>OpenCode Config</summary>
Remote (recommended):
Location:
- macOS: `~/.config/opencode/opencode.json`
- Windows: `%USERPROFILE%\.config\opencode\opencode.json`
```json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"dynamsoft": {
"type": "remote",
"url": "https://simple-dynamsoft-mcp.wonderfulwave-69908b91.eastus2.azurecontainerapps.io/mcp"
}
}
}
```
Local:
```json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"dynamsoft": {
"type": "local",
"command": ["npx", "-y", "simple-dynamsoft-mcp@latest"]
}
}
}
```
</details>
### Claude Desktop
<details>
<summary>Claude Desktop Config</summary>
Location:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
Remote (recommended):
```json
{
"mcpServers": {
"dynamsoft": {
"url": "https://simple-dynamsoft-mcp.wonderfulwave-69908b91.eastus2.azurecontainerapps.io/mcp"
}
}
}
```
Local:
```json
{
"mcpServers": {
"dynamsoft": {
"command": "npx",
"args": ["-y", "simple-dynamsoft-mcp@latest"]
}
}
}
```
</details>
### VS Code with GitHub Copilot
<details>
<summary>VS Code MCP Config</summary>
Global location:
- macOS: `~/Library/Application Support/Code/User/mcp.json`
- Windows: `%APPDATA%\Code\User\mcp.json`
Workspace alternative: `.vscode/mcp.json`
Remote (recommended):
```json
{
"servers": {
"dynamsoft": {
"url": "https://simple-dynamsoft-mcp.wonderfulwave-69908b91.eastus2.azurecontainerapps.io/mcp"
}
}
}
```
Local:
```json
{
"servers": {
"dynamsoft": {
"command": "npx",
"args": ["-y", "simple-dynamsoft-mcp@latest"]
}
}
}
```
</details>
### Cursor
<details>
<summary>Cursor MCP Config</summary>
Location:
- macOS: `~/.cursor/mcp.json`
- Windows: `%USERPROFILE%\.cursor\mcp.json`
Remote (recommended):
```json
{
"mcpServers": {
"dynamsoft": {
"url": "https://simple-dynamsoft-mcp.wonderfulwave-69908b91.eastus2.azurecontainerapps.io/mcp"
}
}
}
```
Local:
```json
{
"mcpServers": {
"dynamsoft": {
"command": "npx",
"args": ["-y", "simple-dynamsoft-mcp@latest"]
}
}
}
```
</details>
### Windsurf
<details>
<summary>Windsurf MCP Config</summary>
Location:
- macOS: `~/.codeium/windsurf/mcp_config.json`
- Windows: `%USERPROFILE%\.codeium\windsurf\mcp_config.json`
Remote (recommended):
```json
{
"mcpServers": {
"dynamsoft": {
"url": "https://simple-dynamsoft-mcp.wonderfulwave-69908b91.eastus2.azurecontainerapps.io/mcp"
}
}
}
```
Local:
```json
{
"mcpServers": {
"dynamsoft": {
"command": "npx",
"args": ["-y", "simple-dynamsoft-mcp@latest"]
}
}
}
```
</details>
### Cline
<details>
<summary>Cline MCP Config</summary>
Location:
- VS Code settings JSON for Cline MCP integration
Remote (recommended):
```json
{
"mcpServers": {
"dynamsoft": {
"url": "https://simple-dynamsoft-mcp.wonderfulwave-69908b91.eastus2.azurecontainerapps.io/mcp"
}
}
}
```
Local:
```json
{
"mcpServers": {
"dynamsoft": {
"command": "npx",
"args": ["-y", "simple-dynamsoft-mcp@latest"]
}
}
}
```
</details>
### Continue
<details>
<summary>Continue MCP Config</summary>
Location:
- `~/.continue/config.yaml` (or workspace Continue config)
Remote (recommended):
```yaml
mcpServers:
dynamsoft:
transport: streamable-http
url: https://simple-dynamsoft-mcp.wonderfulwave-69908b91.eastus2.azurecontainerapps.io/mcp
```
Local:
```yaml
mcpServers:
dynamsoft:
command: npx
args:
- -y
- simple-dynamsoft-mcp@latest
```
</details>
## 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
This server cannot be deployed
Maintenance
ActivityActive
ResponsivenessNo recent community issues