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: ```javascript function handleSubmit(userData, isValid) { const result = userData.name; return result; } ``` Output: ```json { "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 ```bash npx mcp-vibe-check ``` ## Configure in Claude Code Add to your `.mcp.json`: ```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: | Type | Meaning | |---|---| | main character energy | Carries the entire plot | | side quest vibes | Important but easily forgotten | | NPC behavior | Does its job without complaint | | protagonist arc | Started simple, evolved into something bigger | | villain origin story | Nobody asked for this complexity | | comic relief | Technically unnecessary, yet essential | | mentor energy | Older, wiser, called at critical moments | | chosen one potential | Untested but destined for greatness | --- ## 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."*