io.github.webmoleai/mcp-vibe-checker
Vibe-check your code β personality types, energy ratings, aesthetic suggestions.
Ask AI about io.github.webmoleai/mcp-vibe-checker
Powered by Claude Β· Grounded in docs
I know everything about io.github.webmoleai/mcp-vibe-checker. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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
handleSubmita main character, or does it have NPC behavior? Find out. - Variable energy ratings β
xgets "cryptic oracle energy (3/10)".MAXIMUM_RETRY_COUNTgets "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:
| 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."
