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