MCP Vibe Checker

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."*