@thxlion/majin-mcp

Majin MCP server + WebSocket hub.

Quickstart (No MCP)

Run this inside your React project:

npx -y @thxlion/majin-mcp@latest dev

This will:

• Install @thxlion/majin-react (if needed)
• Best-effort add <MajinOverlay /> to your app (common setups)
• Start the Majin WebSocket hub (ws://localhost:3847)
• Start your app dev server (dev script)

Quickstart (MCP)

Run this inside your React project:

npx -y @thxlion/majin-mcp@latest init

This will:

• Install @thxlion/majin-react
• Configure MCP for Claude and Codex
• Print the <MajinOverlay /> snippet to add to your app

Commands

# One-command local dev (hub + app)
npx -y @thxlion/majin-mcp@latest dev

# One-line installer
npx -y @thxlion/majin-mcp@latest init

# Start the WebSocket hub only (no MCP)
npx -y @thxlion/majin-mcp@latest hub

# Configure MCP only (no installs)
npx -y @thxlion/majin-mcp@latest setup

# Diagnose common issues (ports/config)
npx -y @thxlion/majin-mcp@latest diagnose

# Start the MCP server (normally launched by Claude/Codex)
npx -y @thxlion/majin-mcp@latest

Manual MCP Config

Claude Code (CLI)

Add to ~/.claude/mcp_servers.json:

{
  "mcpServers": {
    "majin": {
      "command": "npx",
      "args": ["-y", "@thxlion/majin-mcp@latest"]
    }
  }
}

Codex

Add to ~/.codex/config.toml:

[mcp_servers.majin]
command = "npx"
args = ["-y", "@thxlion/majin-mcp@latest"]

Notes

• The WebSocket hub listens on ws://localhost:3847.
• Tools exposed to the agent: majin_status, majin_compare, majin_clear.