smithery.ai

setup-mcp

Configure scan-mcp MCP server in Claude Code's global configuration.

First seen Apr 14, 2026

Installation

$ npx skills add https://smithery.ai

View on skills.sh ↗ Website ↗

Summary

Configure scan-mcp MCP server in Claude Code's global configuration.
Use when user wants to setup, configure, initialize, enable, or install the scan-mcp MCP server.
Runs preflight checks for prerequisites (Node 22+, SANE tools, tiffcp), helps install missing dependencies, and adds server configuration with user-specified INBOX_DIR.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

frontend-design Same topic

anthropics/skills

Guidance for distinctive, intentional visual design when building new UI or reshaping an existi…

866.4K installs

agent-browser Same topic

vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs

vercel-react-best-practices Same topic

vercel-labs/agent-skills 697.8K installs

web-design-guidelines Same topic

vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs

microsoft-foundry Same topic

microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs

azure-diagnostics Same topic

microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe …

568.9K installs

Also in this package

Other skills from smithery.ai · top by installs.

npx skills add https://smithery.ai

smithery-ai-cli 7.8K frontend-design 6.2K skill-creator 2.5K ck:ui-ux-pro-max 1.3K pdf 1.2K xlsx 966 pptx 894 docx 884 webapp-testing 1 web-design-reviewer 657

Browse all from smithery.ai

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared

Cursor Not declared

Codex Not declared

GitHub Copilot Not declared

Windsurf Not declared

Gemini CLI Not declared

Cline Not declared

OpenCode Not declared

Skill metadata

Parsed from SKILL.md frontmatter.

Declared agents claude-code

Package contents

Files included with this skill beyond the listing page.

skill md SKILL.md 2,998 B
docs SUMMARY.md 351 B

History

Apr 14, 2026 First seen on skills.sh
Sep 9, 2026 First recorded snapshot · 1 installs

SKILL.md

scan-mcp MCP Server Setup

Configure the scan-mcp MCP server in Claude Code's global configuration to enable scanner control.

Setup Workflow

Step 1: Gather User Preferences

Ask user for:

INBOXDIR location (default: ~/Documents/scanneddocuments/inbox)
Installation method: npx (recommended) or local

Step 2: Run Preflight Checks

npx -y scan-mcp --preflight-only

Expected on success: All checks passed!

If preflight fails: Parse output to identify missing dependencies, then guide user through installation (see [PLATFORMS.md](PLATFORMS.md)).

Common missing items:

SANE utilities (scanimage, scanadf)
TIFF tools (tiffcp or ImageMagick convert)

Step 3: Locate Claude Code MCP Configuration

Claude Code config location:

~/.config/claude/config.json (Linux/macOS)
Create if doesn't exist

Step 4: Add or Update Configuration

Configuration structure (npx - recommended):

{
  "mcpServers": {
    "scan": {
      "command": "npx",
      "args": ["-y", "scan-mcp"],
      "env": {
        "INBOX_DIR": "~/Documents/scanned_documents/inbox"
      }
    }
  }
}

Important:

If config.json doesn't exist: Create it with scan-mcp server entry
If config.json exists but no mcpServers: Add mcpServers section
If mcpServers exists: Add or update "scan" entry
Preserve existing MCP server configurations

For local installation (advanced): See [ADVANCED.md](ADVANCED.md).

Step 5: Verify Configuration

Inform user that Claude Code needs restart to pick up new configuration
Suggest testing: claude mcp or asking "scan this document"
If issues occur, suggest running /doctor

Quick Example

User: "Setup scan-mcp"

Actions:

Ask: "Where would you like scanned documents stored? (Default: ~/Documents/scanned_documents/inbox)"
Run: npx -y scan-mcp --preflight-only
If preflight passes:

- Locate/create ~/.config/claude/config.json - Add scan-mcp server configuration - Confirm: "scan-mcp configured. Please restart Claude Code. Test with 'scan this document'."

If preflight fails:

- Identify missing dependencies - Provide installation commands (see PLATFORMS.md) - Re-run preflight after user installs

Reference Materials

[PLATFORMS.md](PLATFORMS.md) — Platform-specific prerequisite installation
[SCANNERS.md](SCANNERS.md) — Scanner permissions and device setup
[TROUBLESHOOTING.md](TROUBLESHOOTING.md) — Common setup issues and solutions
[ADVANCED.md](ADVANCED.md) — Local installation, multiple configs, advanced options

npx skills add https://smithery.ai