Skip to content

waar19/mcpvault

 
 

Repository files navigation

⚡ MCP Vault (mcpv)

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

License Python Platform Status


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"
      }
    }
  }
}

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 98.7%
  • PowerShell 1.3%