mcpv 0.3.3

MCP Vault: Secure Gateway & Booster for Antigravity

⚡ MCP Vault (mcpv)

The Ultimate Performance Booster for AI Agents
"Reduce system lag by 99%, eliminate loading times, and cut token costs by 90%."

🇰🇷 한국어 | 🇨🇳 中文 | 🇷🇺 Русский

[!CAUTION] ⚠️ Compatibility Warning
Currently, this project ONLY supports Windows OS and the Antigravity agent environment.

❓ Why mcpv?

Have you ever felt this while using AI Agents (Antigravity, Cursor)?

"Why is it so heavy?"
"It froze again..."
"Why are the token costs so high?"

mcpv is not just a tool. It is a Turbo Engine for your agent.

🏎️ Overwhelming Performance Difference

Feature	😫 Without mcpv (Before)	⚡ With mcpv (After)	📈 Effect
Speed	No GPU, Laggy UI	Forced GPU Acceleration, Smooth	100x Perceived Speed
Loading	Wait 60s+ every time	0.1s Instant Start (Lazy Load)	Zero Latency
Cost	Resend full code every time	Auto-block Duplicates (Smart Cache)	90% Savings

---

✨ 3 Core Features

1️⃣ Booster Injection (Physical Acceleration)

"Unlock hardware limits with one line"

• Forced GPU Activation: Injects hidden rendering acceleration flags (--enable-gpu-rasterization).
• Permission Bypass: Drops Admin rights to fix drag-and-drop & UI bugs, and bypasses permission requests (Error 740) using RunAsInvoker.
• Zombie Process Killer: Automatically cleans up ghost processes occupying ports.

2️⃣ Smart Valve (Cost Defense)

"Smart wallet protector that saves for you"

• Detects the massive context data (repomix) that agents habitually request.
• First request: Allowed (Full context provided).
• Subsequent requests: Blocked with a 10-token "Already cached" message.
• Physically blocks accidental token bombs.

3️⃣ Gateway Hijacking (Secure Vault)

"Stop struggling with complex configs"

• Root Path Locking: Captures the directory where you run mcpv install and forces the agent to ALWAYS see that directory as the project root. No more "File not found" errors when the agent drifts to other folders.
• Automatically migrates existing complex MCP settings to a secure Vault.
• Original config is safely backed up to mcp_config.original.json.

4️⃣ Smart Router (Flattened Execution)

"One Tool to Rule Them All"

• Unified Interface: The agent doesn't need to know which server has which tool. It just calls run_tool(name="...").
• Auto-Correction: Did the agent make a typo? Did it try to call a server name? mcpv automatically finds the correct tool or suggests the right name.
• Zero-Latency Startup: Only connects to upstream servers when their tools are actually needed.

---

📦 Installation

This project is optimized for Windows. We recommend using uv for a fast and clean installation.

# Install using uv (Recommended)
uv pip install . --system

# OR using standard pip
pip install .

After installing the package, you must run the install command to configure the vault:

mcpv install

---

💻 Commands

Command	Description
mcpv install	(Essential) Installs mcpv as the primary gateway, migrates existing config, and locks the current directory as the project root.
mcpv install --force	Overwrites existing mcpv installation if found.
mcpv start	(Internal) Starts the MCP server. Used by the Antigravity agent, not for humans.

---

🛠️ Verified Recommended Setup

Verified MCP server configuration used by the developer. It creates the best synergy when used with mcpv.

{
  "mcpServers": {
    "rube": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://rube.app/mcp"]
    },
    "open-aware": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://open-aware.qodo.ai/mcp"]
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "PUT_IN_YOUR_API_KEY_HERE"]
    },
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    },
    "mcp-server-neon": {
      "disabled": false,
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.neon.tech/sse"],
      "env": {
        "NEON_API_KEY": "NEVERCHANGE_DONT_PUT_IN_ANYTHING_ELSE_THAN_ME_HERE"
      }
    }
  }
}