MCPTotal CLI

CLI for MCPTotal - MCP proxy with tunnel support.

Installation

npm install -g @mcptotal1/mcpt

Usage

Default: MCP + Tunnel

Run mcp-remote with tunnel for private network access:

mcpt https://mcp.mcptotal.io/mcp-xxx/mcp

Claude Desktop config:

{
  "mcpServers": {
    "mcptotal": {
      "command": "npx",
      "args": ["@mcptotal1/mcpt", "https://mcp.mcptotal.io/mcp-xxx/mcp"]
    }
  }
}

With API key:

mcpt "https://mcp.mcptotal.io/mcp-xxx/mcp?key=your-api-key"

MCP Only (No Tunnel)

mcpt --mcp https://mcp.mcptotal.io/mcp-xxx/mcp

Tunnel Only (No MCP)

Standalone tunnel client (requires key):

mcpt --tunnel https://mcp.mcptotal.io/mcp-xxx/mcp?key=your-api-key

Options

| Option | Description | |--------|-------------| | <url> | MCPTotal space URL (required) | | -m, --mcp | Run MCP proxy (mcp-remote) | | -t, --tunnel | Run tunnel client | | -k, --key <key> | API key (overrides URL parameter) | | --retry-max <n> | Max retry attempts, 0 = unlimited (default: 0) | | --retry-delay <ms> | Initial retry delay in ms (default: 1000) | | -v, --verbose | Enable verbose logging |

If neither --mcp nor --tunnel is specified, both are enabled (default).

Key Sources

Authentication key can be provided via:

• URL parameter: ?key=xxx
• CLI option: --key xxx
• OAuth: Auto-reads from ~/.mcp-auth/ (mcp-remote tokens)

Programmatic Usage

import { TunnelClient } from '@mcptotal1/mcpt';

const client = new TunnelClient({
  url: 'wss://mcp.mcptotal.io/mcp-xxx/tunnel',
  token: 'your-key',
  retryMax: 0,
  retryDelay: 1000,
  verbose: false,
});

client.connect();

License

MIT