MCP Scanner

Stop guessing which MCP servers you need. Let your project tell you.

  __  __  ___ ___   ___
 |  \/  |/ __| _ \ / __|  ___ __ _ _ _  _ _  ___ _ _
 | |\/| | (__|  _/ \__ \ / _/ _` | ' \| ' \/ -_) '_|
 |_|  |_|\___|_|   |___/ \__\__,_|_||_|_||_\___|_|

Scan any project directory, detect the tech stack, and get recommended Model Context Protocol servers with ready-to-paste configuration for Claude Desktop and Claude Code.

Quick Start

npx mcp-scanner

Or scan a specific directory:

npx mcp-scanner /path/to/my/project

Auto-write configs to your system:

npx mcp-scanner --apply

How It Works

1. Scan - Analyzes your project files (package.json, requirements.txt, Dockerfile, tsconfig.json, prisma/, .github/, .env, and more)
2. Detect - Identifies your tech stack: frameworks, databases, cloud providers, tools
3. Recommend - Maps each technology to the best MCP servers from the ecosystem
4. Configure - Generates ready-to-paste JSON configs for Claude Desktop and Claude Code

Supported Technologies

| Category | Technologies | |----------|-------------| | Languages | Node.js, TypeScript, Python, Rust, Go | | Frontend | React, Next.js, Vue.js, Angular, Svelte | | Backend | Express, Fastify, FastAPI, Django, Flask | | Databases | PostgreSQL, MongoDB, Redis, SQLite | | ORM | Prisma | | Cloud | AWS, Vercel, Supabase, Firebase | | DevOps | Docker, GitHub Actions, Sentry | | Tools | ESLint, Puppeteer, Playwright, Stripe, Slack |

MCP Servers Recommended

| Server | For | |--------|-----| | @modelcontextprotocol/server-github | Git repos, PRs, issues | | @modelcontextprotocol/server-filesystem | File operations | | @modelcontextprotocol/server-postgres | PostgreSQL queries | | @modelcontextprotocol/server-sqlite | SQLite queries | | @modelcontextprotocol/server-memory | Persistent memory | | @modelcontextprotocol/server-fetch | HTTP requests | | @anthropic/mcp-puppeteer | Browser automation | | @anthropic/mcp-slack | Slack integration | | mcp-docker | Container management | | mcp-mongo-server | MongoDB queries | | mcp-redis | Redis cache | | mcp-vercel | Vercel deployments | | mcp-supabase | Supabase backend | | mcp-aws | AWS services | | mcp-prisma | Prisma ORM | | mcp-stripe | Stripe payments | | mcp-eslint | Code linting | | mcp-playwright | Browser testing |

CLI Options

Usage: mcp-scanner [options] [directory]

Arguments:
  directory      Project directory to scan (default: current directory)

Options:
  --apply        Write configs to Claude Desktop and Claude Code settings
  --json         Output raw JSON instead of formatted display
  -V, --version  Output the version number
  -h, --help     Display help

JSON Output

For programmatic use, get raw JSON:

npx mcp-scanner --json

Returns:

{
  "stack": [...],
  "recommendations": [...],
  "desktopConfig": { "mcpServers": { ... } },
  "codeConfig": { "mcpServers": { ... } }
}

Install Globally (Optional)

npm install -g mcp-scanner
mcp-scanner

Contributing

1. Fork the repo
2. Add new technology detectors in src/scanner.js
3. Add corresponding MCP server mappings in src/recommender.js
4. Run tests: npm test
5. Submit a PR

License

MIT

Built with Claude Code