@pkgseer/cli

@pkgseer/cli

CLI and MCP server for PkgSeer — package intelligence for developers and AI assistants.

Query package metadata, security vulnerabilities, dependencies, and quality metrics across npm and PyPI registries.

Installation

# Run directly with npx (no install needed)
npx @pkgseer/cli

# Or install globally
npm install -g @pkgseer/cli

Quick Start

# Authenticate (optional, for higher rate limits)
pkgseer login

# Start MCP server for AI assistants
pkgseer mcp

CLI Commands

pkgseer --help           # Show all commands
pkgseer --version        # Show version

pkgseer login            # Authenticate with PkgSeer
pkgseer logout           # Clear stored credentials
pkgseer auth status      # Check authentication status

pkgseer mcp              # Start MCP server

MCP Server

The MCP (Model Context Protocol) server exposes package intelligence tools to AI assistants like Claude, Cursor, and others.

Available Tools

Tool	Description
package_summary	Package metadata, versions, security advisories, quickstart info
package_vulnerabilities	Security vulnerabilities affecting a package
package_dependencies	Direct and transitive dependency tree
package_quality	Quality metrics and scores
compare_packages	Side-by-side comparison of multiple packages

All tools support both npm and pypi registries.

Configuration

Environment Variable	Default	Description
PKGSEER_API_URL	https://pkgseer.dev/api/graphql	API endpoint
PKGSEER_API_TOKEN	—	Authentication token (from pkgseer login)

Cursor Integration

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "pkgseer": {
      "command": "npx",
      "args": ["-y", "@pkgseer/cli", "mcp"]
    }
  }
}

Claude Desktop Integration

Add to Claude Desktop config:

{
  "mcpServers": {
    "pkgseer": {
      "command": "npx",
      "args": ["-y", "@pkgseer/cli", "mcp"]
    }
  }
}

Authentication

Authentication is optional but recommended for higher rate limits.

# Opens browser for OAuth login
pkgseer login

# Credentials stored in ~/.pkgseer/

License

MIT © Juha Litola