npm barcode-scanner-mcpstdioMITupdated 27d ago
MCP server for scanning and generating barcodes and QR codes.
What can you do with Barcode Scanner?
barcode-scanner-mcp
MCP server for scanning and generating barcodes and QR codes.
Use Cases
Decode a barcode from a photo: "What does this barcode say?" → reads the image, detects the barcode format, and returns the decoded text.
Generate a QR code: "Create a QR code for https://example.com" → generates a PNG QR code image with configurable error correction.
Create shipping labels: "Generate a Code 128 barcode for tracking number 1Z999AA10123456784" → produces a barcode image in the specified format.
Verify printed barcodes: "Scan this product barcode and look up the item" → decodes the barcode and returns the text for further lookup.
Setup
Follow the instructions on install-mcp, which generates the right config for your MCP client (Claude Code, Claude Desktop, Cursor, Cline, VS Code, and more).
Tools
| Tool | Description |
|---|---|
decode_image |
Decode a barcode or QR code from an image file or base64 data |
generate_qr |
Generate a QR code PNG from text or a URL |
generate_barcode |
Generate a barcode PNG in 25+ formats (Code 128, EAN-13, UPC-A, etc.) |
Contributing
Pull requests are welcomed on GitHub! To get started:
- Install Git and Node.js
- Clone the repository
- Install dependencies with
npm install - Run
npm run testto run tests - Build with
npm run build
Releases
Versions follow the semantic versioning spec.
To release:
- Use
npm version <major | minor | patch>to bump the version - Run
git push --follow-tagsto push with tags - Wait for GitHub Actions to publish to the NPM registry.
Install
Add Barcode Scanner to your client. Pick the one you use.
claude mcp add barcode-scanner-mcp -- npx -y barcode-scanner-mcpcodex mcp add barcode-scanner-mcp -- npx -y barcode-scanner-mcpamp mcp add barcode-scanner-mcp -- npx -y barcode-scanner-mcp{
"mcpServers": {
"barcode-scanner-mcp": {
"command": "npx",
"args": [
"-y",
"barcode-scanner-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"barcode-scanner-mcp": {
"command": "npx",
"args": [
"-y",
"barcode-scanner-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"barcode-scanner-mcp","command":"npx","args":["-y","barcode-scanner-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"barcode-scanner-mcp": {
"command": "npx",
"args": [
"-y",
"barcode-scanner-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"barcode-scanner-mcp": {
"command": "npx",
"args": [
"-y",
"barcode-scanner-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"barcode-scanner-mcp": {
"command": "npx",
"args": [
"-y",
"barcode-scanner-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"barcode-scanner-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"barcode-scanner-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"barcode-scanner-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"barcode-scanner-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y barcode-scanner-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
3 tools
Barcode Scanner exposes 3 tools to a connected agent.
- decode_image
- Decode a barcode or QR code from an image file or base64 data
- generate_qr
- Generate a QR code PNG from text or a URL
- generate_barcode
- Generate a barcode PNG in 25+ formats (Code 128, EAN-13, UPC-A, etc.)
Score
66 / 100
Good
- Documentation12/25
- Maintenance25/25
- Trust13/20
- Capability4/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 20 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 3 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 1.2.0Latest | Mar 7, 2026 |
| 1.1.2 | Feb 23, 2026 |
| 1.0.0 | Feb 18, 2026 |