open-index/open-npm huggingface dataset:
npm package: @mcpeek/cli
Description: MCP server discovery CLI
Latest version: 0.4.1
Deprecated: Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.

# @mcpeek/cli

Security scanner for MCP (Model Context Protocol) servers. Discovers and analyzes MCP configurations across Claude Desktop, Cursor, Windsurf, and VS Code.

## Installation

```bash
npm install -g @mcpeek/cli
```

## Quick Start

```bash
# Interactive setup (login + optional daemon installation)
mcpeek setup

# Scan for MCP configurations
mcpeek scan

# Upload scan results to API
mcpeek scan --upload 
```

## Commands

### Setup
```bash
mcpeek setup
```
Interactive setup that guides you through login and optionally installs daemon auto-start.

### Scan
```bash
mcpeek scan                    # Scan and output JSON
mcpeek scan --format summary   # Human-readable output
mcpeek scan --output file.json # Save to file
mcpeek scan --upload           # Upload to API (requires login)
```

### Authentication
```bash
mcpeek login   # Login via browser
mcpeek logout  # Logout
mcpeek whoami  # Show current user
```

### Daemon
```bash
mcpeek daemon start     # Start daemon (watches files)
mcpeek daemon stop      # Stop daemon
mcpeek daemon status    # Show daemon status (running, watching, auto-start)
mcpeek daemon install   # Install auto-start on boot
mcpeek daemon uninstall # Uninstall auto-start
```

The daemon automatically syncs your MCP configurations to the API when files change. Check status with `mcpeek daemon status` to see if it's running and watching files.

## What it finds

- Claude Desktop: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Cursor: `~/.cursor/mcp.json`
- Windsurf: `~/.codeium/windsurf/mcp_config.json`
- VS Code: `.vscode/mcp.json` and global settings

## Updating

```bash
npm update -g @mcpeek/cli
```

The CLI automatically checks for updates and notifies you when a new version is available.

## Configuration

Authentication tokens are stored in `~/.mcpeek/config.json`.

### Auth0 Authentication

The CLI uses Auth0 for authentication. Set the following environment variables:

```bash
export AUTH0_DOMAIN=mcpeek.eu.auth0.com
export AUTH0_CLIENT_ID=your_client_id
export AUTH0_CLIENT_SECRET=your_client_secret  # Optional, for confidential clients
export APP_BASE_URL=http://localhost:9876      # Callback URL base (default: 9876)
```

**Note:** For public clients (CLI applications), you typically don't need `AUTH0_CLIENT_SECRET` as the CLI uses PKCE (Proof Key for Code Exchange) for security.

### API URL

Set the API URL via environment variable:
```bash
export MCPEEK_API_URL=https://mcpeek.dev
```

## License

MIT