Vibe Coder

v1.0.0Coding Agentsstable

An MCP server that supercharges AI assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction.

agentsaugmentcodeclaude-desktopclinecursor
Share:
99
Stars
0
Downloads
0
Weekly
0/5

What is Vibe Coder?

Vibe Coder is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that supercharges ai assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction.

An MCP server that supercharges AI assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction.

This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An MCP server that supercharges AI assistants with powerful

Use Cases

Research, plan, generate code, and scaffold projects through natural language. Supercharge AI assistants with powerful software development tools.
freshtechbro

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 10, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx vibe-coder-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Vibe Coder

Vibe Coder MCP is a full-featured Model Context Protocol server that supercharges AI assistants like Claude Desktop, Cursor, and Cline with a suite of software development tools. It provides deep research via Perplexity, codebase mapping across 35+ languages, PRD and user story generation, task management with RDD methodology, and full-stack project scaffolding — all accessible through natural language. Developers use it to compress the research-plan-code-scaffold workflow into a single AI-driven conversation instead of juggling multiple tools.

Prerequisites

  • Node.js 20.0.0 or later installed
  • An OpenRouter API key (free tier available at openrouter.ai) — required for all AI-powered tools
  • An MCP-compatible client such as Claude Desktop, Cursor, or Cline AI
  • A project directory that Vibe Coder can use as its working root
1

Install Vibe Coder MCP globally

Install the package globally so the 'vibe' command is available system-wide, or use npx for a one-off run without installation.

npm install -g vibe-coder-mcp@latest
2

Run the setup wizard

On first use, run the interactive setup wizard to configure your OpenRouter API key, project directories, and configuration files automatically.

vibe --setup
3

Obtain an OpenRouter API key

Visit openrouter.ai, create an account, navigate to the API Keys section, and generate a new key. This key is required for all AI-powered research and generation tools.

4

Configure your MCP client

Add Vibe Coder MCP to your claude_desktop_config.json (or equivalent client config). Set OPENROUTER_API_KEY and VIBE_PROJECT_ROOT environment variables. VIBE_PROJECT_ROOT should point to the root of your active project.

{
  "mcpServers": {
    "vibe-coder-mcp": {
      "command": "npx",
      "args": ["vibe-coder-mcp"],
      "env": {
        "OPENROUTER_API_KEY": "your-openrouter-api-key",
        "VIBE_PROJECT_ROOT": "/path/to/your/project",
        "LOG_LEVEL": "info",
        "NODE_ENV": "production"
      }
    }
  }
}
5

Restart your MCP client

Save the config file and restart Claude Desktop (or reload your IDE). The server should appear as connected and expose all nine tools to your AI assistant.

6

Verify the integration

Ask your AI assistant to use one of the Vibe Coder tools to confirm everything is working. The assistant should invoke the tool and return real results.

Vibe Coder Examples

Client configuration

Claude Desktop claude_desktop_config.json entry for Vibe Coder MCP with required environment variables.

{
  "mcpServers": {
    "vibe-coder-mcp": {
      "command": "npx",
      "args": ["vibe-coder-mcp"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-v1-xxxxxxxxxxxx",
        "VIBE_PROJECT_ROOT": "/Users/yourname/projects/myapp",
        "LOG_LEVEL": "info",
        "NODE_ENV": "production"
      }
    }
  }
}

Prompts to try

Natural language prompts that exercise Vibe Coder's core tools including research, codebase analysis, and code generation.

- "Use vibe to research React best practices for large-scale applications"
- "Map the codebase structure of this project and identify the main modules"
- "Generate a PRD for a multi-tenant SaaS billing system"
- "Generate user stories for an authentication and authorization feature"
- "Scaffold a full-stack Next.js starter kit with TypeScript and Tailwind CSS"
- "Create a task list for implementing a REST API with Node.js and Prisma"

Troubleshooting Vibe Coder

Tools fail with 'API key not configured' or similar OpenRouter errors

Ensure OPENROUTER_API_KEY is set correctly in the env block of your MCP config. The key must start with 'sk-or-v1-'. Re-run 'vibe --setup' to validate the key interactively.

VIBE_PROJECT_ROOT errors or tools cannot find files

Set VIBE_PROJECT_ROOT to an absolute path that exists on disk. The CLI can auto-detect the project root when run from within the project directory, but MCP mode requires an explicit absolute path.

Server does not appear in the MCP client after configuration

Verify Node.js 20+ is installed ('node --version'). If using npx, ensure internet access for package download. Check that the JSON in claude_desktop_config.json has no trailing commas or syntax errors, then fully restart the client.

Frequently Asked Questions about Vibe Coder

What is Vibe Coder?

Vibe Coder is a Model Context Protocol (MCP) server that mcp server that supercharges ai assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Vibe Coder?

Follow the installation instructions on the Vibe Coder GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Vibe Coder?

Vibe Coder works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Vibe Coder free to use?

Yes, Vibe Coder is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Coding Agents MCP Servers

Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "vibe-coder-mcp": { "command": "npx", "args": ["-y", "vibe-coder-mcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Vibe Coder?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides