ccmvn

Run Maven inside the Claude Code web sandbox.

Installation

npm install -g ccmvn

Or use directly with npx:

npx ccmvn clean install

Usage

Run any Maven command with:

ccmvn [maven-args]

Examples:

ccmvn clean install
ccmvn package
ccmvn test
ccmvn compile

How It Works

This package wraps a Node.js proxy server that enables Maven to access Maven Central in restricted sandbox environments that block outbound HTTPS and lack DNS resolution.

The script creates a three-layer proxy chain:

Maven -> Local Proxy -> Upstream Sandbox Proxy -> Maven Central
       (HTTP)        (HTTP CONNECT)         (HTTP/2 over TLS)

Architecture

1. Maven → Local Proxy (localhost:8080)

   • Plain HTTP communication
   • Maven configured via ~/.m2/settings.xml
   • No authentication required

2. Local Proxy → Upstream Proxy

   • HTTP CONNECT tunneling with JWT authentication
   • Upstream proxy performs DNS resolution

3. Local Proxy → Maven Central

   • HTTP/2 over TLS with ALPN negotiation
   • Secure, encrypted connection to Maven Central

Requirements

• Node.js 12 or later
• Maven 3.x
• HTTPS_PROXY environment variable (for sandboxed environments)

Format: http://username:jwt_token@host:port

Security

• JWT tokens are extracted from the HTTPS_PROXY environment variable
• Local proxy only accessible on localhost
• TLS certificate validation for Maven Central
• End-to-end encryption maintained through the tunnel

License

MIT