ASM MCP Proxy

Stdio to HTTP proxy for ASM MCP Gateway. Connects Model Context Protocol (MCP) clients like Windsurf, Cursor, and Claude Desktop to ASM Platform running on Cloudflare Workers.

Features

• ✅ Stdio ↔ HTTP Bridge: Converts MCP stdio protocol to HTTP/JSON-RPC
• ✅ JWT Authentication: Secure token-based auth with auto-refresh
• ✅ Local Tools: File operations, git, terminal commands
• ✅ Intelligent Router: Routes tools between local and cloud
• ✅ 29+ ASM Tools: Full access to ASM Platform capabilities

Quick Start

Option 1: NPX (Recommended)

No installation needed! Use directly in your MCP config:

{
  "mcpServers": {
    "asm-platform": {
      "command": "npx",
      "args": ["-y", "asm-mcp-proxy"],
      "env": {
        "MCP_JWT_TOKEN": "your-jwt-token-here",
        "MCP_GATEWAY_URL": "https://asm-api-gateway.vitor-9a3.workers.dev"
      }
    }
  }
}

Option 2: Global Install

npm install -g asm-mcp-proxy

Then in your MCP config:

{
  "mcpServers": {
    "asm-platform": {
      "command": "asm-mcp-proxy",
      "env": {
        "MCP_JWT_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

Getting Your JWT Token

curl -X POST https://asm-api-gateway.vitor-9a3.workers.dev/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"your-password"}'

Copy the token field from the response.

Environment Variables

• MCP_JWT_TOKEN (required): Your authentication token
• MCP_GATEWAY_URL (optional): Gateway URL (default: https://asm-api-gateway.vitor-9a3.workers.dev)
• MCP_DEBUG (optional): Enable debug logging (true/false)

Supported Clients

• ✅ Windsurf (Codeium)
• ✅ Cursor
• ✅ Claude Desktop
• ✅ Any MCP-compatible client

Architecture

MCP Client (Windsurf/Cursor)
    ↓ stdio (JSON-RPC 2.0)
asm-mcp-proxy
    ↓ HTTPS (JSON-RPC 2.0)
ASM API Gateway (Cloudflare Workers)
    ↓
ASM Platform (29+ tools)

Available Tools

The proxy provides access to 29+ ASM tools including:

• Memory management (L1/L2/L3)
• Pattern storage and search
• Code generation (Nuxt, components, APIs)
• Validation (Gate5, AI review)
• Git operations
• File operations (read, write, edit)
• Terminal commands
• And more...

License

MIT

Support

For issues and questions, visit: https://github.com/vitor606/ASM-MCP