mcp-vibe-check

Your code has energy. Time to find out what kind.

An MCP server that gives your code a vibe check — assigning personality types to functions, rating variable name energy, and suggesting more aesthetic alternatives. Because userData was never the right name. It should be soulContainer.

What It Does

• Personality types for functions — Is handleSubmit a main character, or does it have NPC behavior? Find out.
• Variable energy ratings — x gets "cryptic oracle energy (3/10)". MAXIMUM_RETRY_COUNT gets "dramatic monologue energy (9/10)". They earned it.
• Aesthetic name suggestions — isValid → vibesPassing. error → chaosEvent. You're welcome.
• Overall vibe score — A completely arbitrary number between 1 and 10 that means nothing and everything.
• Code aesthetic assessment — Qualitative vibes. Unscientific. Occasionally accurate.

Example

Input:

function handleSubmit(userData, isValid) {
  const result = userData.name;
  return result;
}

Output:

{
  "overallVibe": "cozy cottage-core with hints of cyberpunk",
  "vibeScore": 6.8,
  "functions": [
    {
      "name": "handleSubmit",
      "personality": "main character energy",
      "assessment": "This function carries the entire plot"
    }
  ],
  "variables": [
    {
      "name": "userData",
      "energy": 7,
      "assessment": "classic protagonist (7/10) — reliable, not flashy",
      "suggestion": "soulContainer"
    },
    {
      "name": "isValid",
      "energy": 7,
      "assessment": "classic protagonist (7/10) — reliable, not flashy",
      "suggestion": "vibesPassing"
    },
    {
      "name": "result",
      "energy": 5,
      "assessment": "functional but uninspired (5/10) — exists, which is something",
      "suggestion": "manifestation"
    }
  ],
  "codeAesthetic": "Your code reads like a mystery novel — lots of setup, unclear payoff",
  "recommendation": "Consider adding more comments for dramatic tension"
}

Install

npx mcp-vibe-check

Configure in Claude Code

Add to your .mcp.json:

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

Then ask Claude: "What vibes does this codebase give off?"

Personality Types

Your functions can be:

FAQ

Is this useful for code review? No. That's the point.

Will this improve my code quality? Statistically unlikely. Spiritually, possibly.

Why does `console.log` hurt my vibe score? Because it's not aesthetic. Use a proper logger. Your stdout deserves better.

My function got "NPC behavior". Should I be offended? Only if your function has feelings. Which, based on this tool, it might.

"Not all code reviews need to be actionable. Some just need to be vibes."