playbooks
Learn Cursor Rules Windsurf Rules MCPs Modes
Log in

Vibe Coder (AI-Assisted Development) MCP server

Provides AI-assisted development tools for semantic routing, code generation, refactoring, and project management with intelligent request handling and specialized Git integration capabilities.
Back to servers
Setup instructions
Provider
FreshTechBro
Release date
Mar 26, 2025
Language
TypeScript
Stats
61 stars
View on GitHub

Vibe Coder MCP Server is a powerful integration for your AI assistant (like Cursor, Cline AI, or Claude Desktop) that provides specialized tools for software development tasks including research, planning, code generation, and project scaffolding through the Model Context Protocol (MCP).

Installation

Follow these steps to get the Vibe Coder MCP server up and running with your AI assistant.

Prerequisites

Before you begin, ensure you have:

  1. Node.js v18 or higher

    node -v

    If not installed or outdated, download from nodejs.org.

  2. Git

    git --version

    If not installed, download from git-scm.com.

  3. OpenRouter API Key

    • Create an account at openrouter.ai
    • Generate an API key in your account settings

Setup Process

1. Clone the Repository

git clone https://github.com/freshtechbro/vibe-coder-mcp.git
cd vibe-coder-mcp

2. Run the Setup Script

For Windows:

setup.bat

For macOS or Linux:

chmod +x setup.sh
./setup.sh

The setup script will:

  • Check Node.js version
  • Install dependencies
  • Create necessary directories
  • Build the TypeScript project
  • Create a default .env file

3. Configure Your API Key

Open the .env file in the main directory and add your OpenRouter API key:

OPENROUTER_API_KEY=your_openrouter_api_key_here

4. Integrate with Your AI Assistant

4.1 Find Your Project's Absolute Path

Windows:

cd build
echo %cd%\index.js

macOS/Linux:

cd build
pwd

Then append /index.js to the result.

4.2 Create Configuration Block

Use this JSON template, replacing the placeholders:

"vibe-coder-mcp": {
  "command": "node",
  "args": ["YOUR_ABSOLUTE_PATH_TO_index.js"],
  "env": {
    "NODE_ENV": "production",
    "OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY",
    "OPENROUTER_BASE_URL": "https://openrouter.ai/api/v1",
    "GEMINI_MODEL": "google/gemini-pro",
    "PERPLEXITY_MODEL": "perplexity/sonar-small-online"
  },
  "disabled": false,
  "autoApprove": [
    "research", 
    "generate-rules", 
    "generate-prd", 
    "generate-user-stories", 
    "generate-task-list",
    "generate-fullstack-starter-kit",
    "generate-code-stub",
    "refactor-code",
    "analyze-dependencies",
    "git-summary",
    "run-workflow"
  ]
}
4.3 Add to Your AI Assistant
Cursor AI / Windsurf
  1. Open Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
  2. Type: Preferences: Open User Settings (JSON)
  3. Add your configuration to the mcpServers object
  4. Save and restart Cursor/Windsurf
Cline AI
  1. Open your Cline settings file:
    • Windows: C:\Users\[YourUsername]\AppData\Roaming\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
    • macOS: ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
    • Linux: ~/.config/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  2. Add your configuration to the mcpServers object
  3. Save and restart VS Code
Claude Desktop
  1. Open your Claude Desktop settings file:
    • Windows: C:\Users\[YourUsername]\AppData\Roaming\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json
  2. Add your configuration to the mcpServers object
  3. Save and restart Claude Desktop

Usage

After installation, you can use the following commands with your AI assistant:

Research and Planning

Research modern JavaScript frameworks

Generate a PRD for a task management application

Create development rules for a mobile banking application

Generate user stories for an e-commerce website

Create a task list for a weather app

Code Generation and Analysis

Generate a python function stub named 'calculate_discount' that takes price and percentage

Refactor this code to use async/await: [paste code snippet]

Analyze dependencies in package.json

Show unstaged git changes

Project Scaffolding

Create a starter kit for a React/Node.js blog application with user authentication

Workflow Execution

Run workflow newProjectSetup with input { "projectName": "my-new-app", "description": "A simple task manager" }

Troubleshooting

Connection Issues

If the MCP server isn't detected:

  • Verify the path in the args array is correct
  • Ensure all slashes are forward slashes (/) even on Windows
  • Check for valid JSON syntax in configuration

If tools don't work:

  • Ensure "disabled": false is set
  • Verify tool names in the autoApprove array match exactly

API Key Issues

  • Verify your OpenRouter API key is active and has sufficient credits
  • Check the key is correct in both the .env file and your assistant's configuration

Local Testing

Run the server directly for testing:

# Production mode (stdio)
npm start

# Development mode (stdio with pretty logs)
npm run dev

# HTTP interface mode
npm run start:sse

The server will store generated files in the workflow-agent-files directory for reference.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "vibe-coder-mcp" '{"command":"node","args":["PATH_PLACEHOLDER"],"env":{"NODE_ENV":"production","OPENROUTER_API_KEY":"KEY_PLACEHOLDER","OPENROUTER_BASE_URL":"https://openrouter.ai/api/v1","GEMINI_MODEL":"google/gemini-pro","PERPLEXITY_MODEL":"perplexity/sonar-small-online"},"disabled":false,"autoApprove":["research","generate-rules","generate-prd","generate-user-stories","generate-task-list","generate-fullstack-starter-kit","generate-code-stub","refactor-code","analyze-dependencies","git-summary","run-workflow"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "vibe-coder-mcp": {
            "command": "node",
            "args": [
                "PATH_PLACEHOLDER"
            ],
            "env": {
                "NODE_ENV": "production",
                "OPENROUTER_API_KEY": "KEY_PLACEHOLDER",
                "OPENROUTER_BASE_URL": "https://openrouter.ai/api/v1",
                "GEMINI_MODEL": "google/gemini-pro",
                "PERPLEXITY_MODEL": "perplexity/sonar-small-online"
            },
            "disabled": false,
            "autoApprove": [
                "research",
                "generate-rules",
                "generate-prd",
                "generate-user-stories",
                "generate-task-list",
                "generate-fullstack-starter-kit",
                "generate-code-stub",
                "refactor-code",
                "analyze-dependencies",
                "git-summary",
                "run-workflow"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "vibe-coder-mcp": {
            "command": "node",
            "args": [
                "PATH_PLACEHOLDER"
            ],
            "env": {
                "NODE_ENV": "production",
                "OPENROUTER_API_KEY": "KEY_PLACEHOLDER",
                "OPENROUTER_BASE_URL": "https://openrouter.ai/api/v1",
                "GEMINI_MODEL": "google/gemini-pro",
                "PERPLEXITY_MODEL": "perplexity/sonar-small-online"
            },
            "disabled": false,
            "autoApprove": [
                "research",
                "generate-rules",
                "generate-prd",
                "generate-user-stories",
                "generate-task-list",
                "generate-fullstack-starter-kit",
                "generate-code-stub",
                "refactor-code",
                "analyze-dependencies",
                "git-summary",
                "run-workflow"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect

Want to 10x your AI skills?

Get a free account and learn to code + market your apps using AI (with or without vibes!).

Nah, maybe later