{
  "markdown": "# mcp-vibe-check\n\n> Your code has energy. Time to find out what kind.\n\nAn 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`.\n\n---\n\n## What It Does\n\n- **Personality types for functions** — Is `handleSubmit` a main character, or does it have NPC behavior? Find out.\n- **Variable energy ratings** — `x` gets \"cryptic oracle energy (3/10)\". `MAXIMUM_RETRY_COUNT` gets \"dramatic monologue energy (9/10)\". They earned it.\n- **Aesthetic name suggestions** — `isValid` → `vibesPassing`. `error` → `chaosEvent`. You're welcome.\n- **Overall vibe score** — A completely arbitrary number between 1 and 10 that means nothing and everything.\n- **Code aesthetic assessment** — Qualitative vibes. Unscientific. Occasionally accurate.\n\n---\n\n## Example\n\nInput:\n```javascript\nfunction handleSubmit(userData, isValid) {\n  const result = userData.name;\n  return result;\n}\n```\n\nOutput:\n```json\n{\n  \"overallVibe\": \"cozy cottage-core with hints of cyberpunk\",\n  \"vibeScore\": 6.8,\n  \"functions\": [\n    {\n      \"name\": \"handleSubmit\",\n      \"personality\": \"main character energy\",\n      \"assessment\": \"This function carries the entire plot\"\n    }\n  ],\n  \"variables\": [\n    {\n      \"name\": \"userData\",\n      \"energy\": 7,\n      \"assessment\": \"classic protagonist (7/10) — reliable, not flashy\",\n      \"suggestion\": \"soulContainer\"\n    },\n    {\n      \"name\": \"isValid\",\n      \"energy\": 7,\n      \"assessment\": \"classic protagonist (7/10) — reliable, not flashy\",\n      \"suggestion\": \"vibesPassing\"\n    },\n    {\n      \"name\": \"result\",\n      \"energy\": 5,\n      \"assessment\": \"functional but uninspired (5/10) — exists, which is something\",\n      \"suggestion\": \"manifestation\"\n    }\n  ],\n  \"codeAesthetic\": \"Your code reads like a mystery novel — lots of setup, unclear payoff\",\n  \"recommendation\": \"Consider adding more comments for dramatic tension\"\n}\n```\n\n---\n\n## Install\n\n```bash\nnpx mcp-vibe-check\n```\n\n## Configure in Claude Code\n\nAdd to your `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"vibe-check\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-vibe-check\"]\n    }\n  }\n}\n```\n\nThen ask Claude: \"What vibes does this codebase give off?\"\n\n---\n\n## Personality Types\n\nYour functions can be:\n\n| Type | Meaning |\n|---|---|\n| main character energy | Carries the entire plot |\n| side quest vibes | Important but easily forgotten |\n| NPC behavior | Does its job without complaint |\n| protagonist arc | Started simple, evolved into something bigger |\n| villain origin story | Nobody asked for this complexity |\n| comic relief | Technically unnecessary, yet essential |\n| mentor energy | Older, wiser, called at critical moments |\n| chosen one potential | Untested but destined for greatness |\n\n---\n\n## FAQ\n\n**Is this useful for code review?**\nNo. That's the point.\n\n**Will this improve my code quality?**\nStatistically unlikely. Spiritually, possibly.\n\n**Why does `console.log` hurt my vibe score?**\nBecause it's not aesthetic. Use a proper logger. Your stdout deserves better.\n\n**My function got \"NPC behavior\". Should I be offended?**\nOnly if your function has feelings. Which, based on this tool, it might.\n\n---\n\n*\"Not all code reviews need to be actionable. Some just need to be vibes.\"*\n",
  "bytes": 3354,
  "sha": "bf5af6696346d91b2e78b2bbb75c0cd699328e945c9fcc3693eae1b9ed4f2858",
  "repo_slug": "webmoleai/mcp-vibe-checker",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_webmoleai_mcp_vibe_checker_27e0b973/readme"
}