Install and IDE setup

VibeLens is a plain MCP server over stdio, so every MCP-capable client takes the same shape. Claude Code additionally gets a plugin that bundles the skills, subagents and hooks.

Requirements#

• Node.js 20 or newer. Playwright 1.62 requires it.
• Chromium for Playwright, installed once:

npx playwright install chromium

There is no global install step for the server itself: npx fetches it on first run.

Claude Code#

Install as a plugin. This is the recommended path because it also installs the twelve skills, four subagents and two advisory hooks:

claude plugin marketplace add soumyachk101/VibeLens
claude plugin install vibelens@vibelens

Or add it as a bare MCP server:

claude mcp add vibelens --scope user -- npx -y mcp-vibelens@1
claude mcp add vibelens --scope project -- npx -y mcp-vibelens@1

--scope user makes it available in every project; --scope project writes a .mcp.json you can commit for your team. Verify with /mcp in a session: vibelens should be listed as connected.

OpenAI Codex#

codex mcp add vibelens -- npx -y mcp-vibelens@1

Codex shares this configuration between the CLI and the IDE extension, so it only needs doing once. To edit it by hand, add this to ~/.codex/config.toml:

[mcp_servers.vibelens]
command = "npx"
args = ["-y", "mcp-vibelens@1"]

Check with codex mcp list. Codex supports local stdio servers only, which is exactly what VibeLens is.

Cursor#

Create .cursor/mcp.json in your project, or ~/.cursor/mcp.json for every project:

{
  "mcpServers": {
    "vibelens": {
      "command": "npx",
      "args": ["-y", "mcp-vibelens@1"]
    }
  }
}

Then enable vibelens under Settings, MCP.

Google Antigravity#

Open the MCP configuration from the UI — the three-dot menu in chat, then MCP Servers, Manage MCP Servers, View raw config; or Settings, Customizations, Open MCP Config — and paste the same JSON block. Depending on your build the file is at one of:

• ~/.gemini/antigravity/mcp_config.json
• ~/.gemini/config/mcp_config.json on newer builds and the Antigravity CLI

Using the in-app menu is the reliable way to open the right one.

Windsurf#

~/.codeium/windsurf/mcp_config.json, same JSON block as Cursor.

VS Code, GitHub Copilot agent mode#

.vscode/mcp.json uses servers rather than mcpServers:

{
  "servers": {
    "vibelens": { "command": "npx", "args": ["-y", "mcp-vibelens@1"] }
  }
}

Claude Desktop#

~/Library/Application Support/Claude/claude_desktop_config.json on macOS, same JSON block as Cursor. Restart the app afterwards.

From source#

git clone https://github.com/soumyachk101/VibeLens.git
cd VibeLens
npm install
npx playwright install chromium
npm run build
npm test
npm run smoke

Then point your IDE at node /absolute/path/to/VibeLens/dist/index.js.

It is not connecting#

Start with Troubleshooting; it covers the per-IDE diagnosis and every error code the tool can return.