npm run start:http

┌──────────────────────────────────────────────────────────────────┐
│                           AI Tools                               │
│                                                                  │
│   ┌─────────────────────────┐    ┌────────────────────────────┐  │
│   │  Claude Desktop         │    │  Gemini  │  ChatGPT  │ etc │  │
│   │  Cursor / Windsurf / Zed│    └────────────────────────────┘  │
│   │  any MCP-compatible tool│              │                     │
│   └────────────┬────────────┘              │ HTTP + SSE          │
│                │ MCP stdio (JSON-RPC)       │ localhost:3333      │
└────────────────┼───────────────────────────┼─────────────────────┘
                 │                            │
       ┌─────────▼──────────┐      ┌──────────▼─────────┐
       │     server.ts      │      │   http-server.ts   │
       │    (stdio mode)    │      │  (HTTP / SSE mode) │
       └─────────┬──────────┘      └──────────┬─────────┘
                 └──────────────┬─────────────┘
                                │
                    ┌───────────▼───────────┐
                    │      17 MCP Tools     │
                    │                       │
                    │  get_active_project   │
                    │  get_project_info     │
                    │  get_git_status       │
                    │  get_git_diff         │
                    │  scan_dev_servers     │
                    │  check_port           │
                    │  view_page            │
                    │  get_api_response     │
                    │  read_file            │
                    │  edit_file            │
                    │  patch_file           │
                    │  restore_backup       │
                    │  list_files           │
                    │  delete_file          │
                    │  move_file            │
                    │  search_files         │
                    │  run_command          │
                    └───────────┬───────────┘
                                │  allowlist guards + auto-backup
                                │
               ┌────────────────▼────────────────┐
               │      Your local dev project     │
               │      localhost:5173 / :3000     │
               │      src/  package.json  etc.   │
               └─────────────────────────────────┘

universal-dev-mcp/
├── src/
│   ├── cli/
│   │   └── switch.ts          Cross-platform CLI for switching projects (mcp-switch)
│   ├── core/
│   │   ├── events.ts          Central activity bus & SSE event emitter
│   │   ├── project-manager.ts Multi-project state manager & editor config generator
│   │   ├── registry.ts        Tool registry & OpenAI tool-calling adapter
│   │   └── types.ts           TypeScript interfaces and telemetry schemas
│   ├── tools/
│   │   ├── api.ts             get_api_response
│   │   ├── browser.ts         view_page, check_port
│   │   ├── commands.ts        run_command (with cwd and injection checks)
│   │   ├── files.ts           read_file, edit_file, patch_file, list_files, delete_file, move_file, restore_backup
│   │   ├── git.ts             get_git_status, get_git_diff
│   │   ├── index.ts           Aggregates and registers all tools
│   │   ├── project.ts         get_project_info, get_active_project
│   │   ├── radar.ts           scan_dev_servers (parallel port scanner)
│   │   └── search.ts          search_files
│   ├── utils/
│   │   ├── backup.ts          File backup creation, rotation, diffing, and restoration
│   │   ├── fetch.ts           HTTP fetch helpers and HTML parsing utilities
│   │   ├── fs.ts              File tree generation and path helpers
│   │   └── security.ts        Port, command, shell-injection, and path access guards
│   ├── config.ts              Environment variables and mutable live configuration
│   ├── http-server.ts         Express HTTP + SSE server & Web UI host (port 3333)
│   └── server.ts              MCP stdio entry point (JSON-RPC)
├── ui/                        Embedded Web UI Dashboard (React + Vite + Tailwind)
│   ├── src/
│   │   ├── api/client.ts      Typed REST & SSE client
│   │   ├── components/        Navbar, Home, ProjectHub, ActivityFeed, BackupCenter, DevRadar, ApiPlayground
│   │   └── hooks/             useActivityStream
│   └── public/                Mascot and visual assets
├── tests/                     Automated Vitest test suite
│   ├── backup.test.ts         Backup creation, rotation, and rollback tests
│   ├── security.test.ts       Path traversal, allowlist, and injection prevention tests
│   └── tools.test.ts          Git, radar, and file tool execution tests
├── projects.json              Project registry for mcp-switch and Project Hub
├── .env.example               Configuration template
├── .gitignore
├── LICENSE                    MIT License
├── package.json
├── tsconfig.json
└── README.md

git clone https://github.com/rj9884/universal-dev-mcp
cd universal-dev-mcp
npm install

npm link

cp .env.example .env

# Absolute path to your active project repository
PROJECT_ROOT=/home/yourname/projects/my-app

# Ports your dev servers run on (comma-separated)
# Vite=5173  Next.js/CRA=3000  Angular=4200  Vue=8080  Django=8000
ALLOWED_PORTS=3000,5173,8080

# Shell commands the AI is permitted to run
ALLOWED_COMMANDS=npm test,npm run lint,npm run build,npx tsc --noEmit

# Port for the HTTP server & Web UI Dashboard
HTTP_PORT=3333

# Optional: restrict file writes to specific subdirectories (defaults to PROJECT_ROOT)
# ALLOWED_WRITE_DIRS=/home/yourname/projects/my-app/src

# Optional: require an API key on all HTTP endpoints (passed via x-api-key header)
# MCP_API_KEY=your-secret-key

{
  "mcpServers": {
    "universal-dev-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/universal-dev-mcp/dist/server.js"],
      "env": {
        "PROJECT_ROOT": "/absolute/path/to/your/project",
        "ALLOWED_PORTS": "5173,3000,8080",
        "ALLOWED_COMMANDS": "npm test,npm run lint,npm run build,npx tsc --noEmit"
      }
    }
  }
}

{
  "mcpServers": {
    "universal-dev-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/universal-dev-mcp/dist/server.js"],
      "env": {
        "PROJECT_ROOT": "/absolute/path/to/your/project",
        "ALLOWED_PORTS": "5173,3000,8080",
        "ALLOWED_COMMANDS": "npm test,npm run lint,npm run build,npx tsc --noEmit"
      }
    }
  }
}

{
  "mcpServers": {
    "universal-dev-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/universal-dev-mcp/dist/server.js"],
      "env": {
        "PROJECT_ROOT": "/absolute/path/to/your/project",
        "ALLOWED_PORTS": "5173,3000,8080",
        "ALLOWED_COMMANDS": "npm test,npm run lint,npm run build,npx tsc --noEmit"
      }
    }
  }
}

{
  "experimental": {
    "model_context_protocol": {
      "servers": [
        {
          "id": "universal-dev-mcp",
          "command": "node",
          "args": ["/absolute/path/to/universal-dev-mcp/dist/server.js"],
          "env": {
            "PROJECT_ROOT": "/absolute/path/to/your/project",
            "ALLOWED_PORTS": "5173,3000,8080",
            "ALLOWED_COMMANDS": "npm test,npm run lint,npm run build,npx tsc --noEmit"
          }
        }
      ]
    }
  }
}

{
  "projects": [
    {
      "name": "my-react-app",
      "root": "/home/yourname/projects/my-react-app",
      "allowed_ports": "3000,5173",
      "allowed_commands": "npm run build,npm test,npm run dev"
    },
    {
      "name": "my-backend-api",
      "root": "/home/yourname/projects/my-backend-api",
      "allowed_ports": "8080",
      "allowed_commands": "npm run build,npm test"
    }
  ]
}

# Interactive menu — pick a project from a numbered list
npx mcp-switch

# Switch directly by name across all installed editors
npx mcp-switch use my-react-app

# Switch for a specific editor only (claude, cursor, windsurf, or zed)
npx mcp-switch use my-react-app --editor cursor

# Show the currently active project
npx mcp-switch current

# List all projects (active project marked with *)
npx mcp-switch list

# Add a new project interactively
npx mcp-switch add

npm run start:http

curl -X POST http://localhost:3333/call \
  -H "Content-Type: application/json" \
  -d '{"name": "get_git_status", "arguments": {}}'

import { GoogleGenerativeAI } from "@google/generative-ai";

const MCP_URL = "http://localhost:3333";

async function getMcpTools() {
  const res = await fetch(`${MCP_URL}/openai/tools`);
  const { tools } = await res.json();
  return tools;
}

async function callMcpTool(name: string, args: Record<string, unknown>): Promise<string> {
  const res = await fetch(`${MCP_URL}/openai/call`, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      tool_calls: [
        { id: "call_1", function: { name, arguments: JSON.stringify(args) } },
      ],
    }),
  });
  const { tool_results } = await res.json();
  return tool_results[0].content;
}

async function main() {
  const genAI = new GoogleGenerativeAI(process.env.GEMINI_API_KEY!);
  const tools = await getMcpTools();

  const model = genAI.getGenerativeModel({
    model: "gemini-1.5-pro",
    tools: [{ functionDeclarations: tools.map((t: any) => t.function) }],
  });

  const chat = model.startChat();
  let result = await chat.sendMessage("Check git status and active project.");

  while (result.response.functionCalls()?.length) {
    const toolResponses = await Promise.all(
      result.response.functionCalls()!.map(async (call) => {
        const output = await callMcpTool(call.name, call.args as Record<string, unknown>);
        return { functionResponse: { name: call.name, response: { result: output } } };
      })
    );
    result = await chat.sendMessage(toolResponses);
  }

  console.log(result.response.text());
}

main();

npm test

Which project is currently active?

Show git status and summarize the last 5 commits.

Show the git diff for src/components/Navbar.tsx.

Scan local dev ports to see which dev servers are running.

Check if my Vite dev server is responding on port 5173.

Fetch the homepage from localhost:5173 and describe the UI layout.

Search for all occurrences of 'useActivityStream' across the project.

Run npm test and summarize any failures.

Fix the TypeScript error in src/utils/backup.ts on line 42.

Restore src/components/Navbar.tsx to its latest backup snapshot.