SCP Local MCP Server

Local MCP server for Shopper Context Protocol (SCP).

Installation

npm install
npm run build

Usage

With Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "scp": {
      "command": "node",
      "args": ["/path/to/local_mcp/dist/index.js"]
    }
  }
}

Direct Usage

npm start

Development

npm run dev    # Watch mode
npm run build  # Production build
npm test       # Run tests

Configuration

Configuration file: ~/.scp/config.json

{
  "dns_resolver": "1.1.1.1",
  "dns_cache_ttl": 86400,
  "poll_interval": 2,
  "max_poll_attempts": 150,
  "token_refresh_threshold": 300,
  "request_timeout": 30000,
  "demo_mode": true,
  "demo_endpoint": "http://localhost:8787/v1"
}

Demo Mode

By default, demo mode is enabled and all SCP requests will be directed to http://localhost:8787/v1. This is useful for local testing and demos without needing to set up DNS records or configure domain discovery.

To disable demo mode and use real DNS-based discovery:

1. Edit ~/.scp/config.json and set "demo_mode": false
2. Or delete the config file - it will regenerate with demo mode enabled by default

Environment Variable Override

You can also override the endpoint for all requests using an environment variable:

SCP_TEST_ENDPOINT=http://localhost:8787/v1 node dist/index.js

This takes precedence over both demo mode and DNS discovery.

Data Storage

• Tokens: ~/.scp/tokens.db (SQLite, encrypted)
• Config: ~/.scp/config.json

MCP Tools

• scp_authorize - Authorize access to a merchant
• scp_check_authorization - Check authorization status
• scp_revoke_authorization - Revoke access to a merchant
• scp_discover - Discover SCP endpoint for a domain

MCP Resources

• scp://{domain}/orders - Order history
• scp://{domain}/loyalty - Loyalty status
• scp://{domain}/offers - Active offers
• scp://{domain}/preferences - Customer preferences
• scp://{domain}/intents - Shopping intents