# kaomoji-mcp

MCP server that returns a random kaomoji for any mood. **96,000+ unique kaomoji** merged from 4 open datasets.

## Quick start

```bash
npm install
node index.js
```

## Tools

### `kaomoji`

Get a random kaomoji for a mood.

```
kaomoji({ mood: "happy" })    →  ╰(￣▽￣)╯
kaomoji({ mood: "angry" })    →  (╬◣д◢)
kaomoji({ mood: "sleepy" })   →  (-_-)zzz
kaomoji({ mood: "love" })     →  (♡ε♥)
kaomoji({ mood: "huh" })      →  (o_O)?
```

Supports natural language: `happy`, `mad`, `hmm`, `zzz`, `omg`, `cat`, etc.

### `kaomoji_moods`

List all 30 available moods and entry counts.

## Available moods

| Mood | Count | Examples |
|------|-------|---------|
| happy | 1,649 | (＾▽＾) (^o^)/ |
| sad | 3,442 | (╥﹏╥) (T_T) |
| angry | 2,767 | (╬◣д◢) (#°Д°) |
| love | 16,879 | (♡ε♥) (◕ᴗ◕✿) |
| cute | 14,108 | (｡♡‿♡｡) (◕‿◕) |
| excited | 536 | \\(^o^)/ |
| playful | 1,095 | (^.~) ಠ‿↼ |
| mischievous | 168 | (¬_¬) (￣ω￣;) |
| cool | 132 | (⌐■_■) |
| smug | 132 | (￣^￣) |
| embarrassed | 214 | (^^;) m(_ _)m |
| shy | 118 | (ᵕ̈) |
| surprised | 812 | Σ(ﾟДﾟ) |
| worried | 36 | (；`ε´) |
| nervous | 995 | (._.;) |
| confused | 56 | (o_O)? |
| thinking | 157 | (-_-) (..) |
| sleepy | 655 | (-_-)zzz (ーωー) |
| tired | 118 | (￣o￣) |
| chill | 279 | ( ´ω`) |
| neutral | 56,782 | (・_・) |
| greeting | 953 | (^_^)/ ヾ(＾∇＾) |
| flirty | 941 | (^.~) ಠ‿↼ |
| animal | 8,859 | (=^･ω･^=) ʕ•ᴥ•ʔ |
| cry | 72 | (╥﹏╥) |

## Data sources

| Source | Entries | What |
|--------|---------|------|
| [kaomojiya-collection](https://github.com/kaomojiya-collection/kaomoji-collection) | 41,596 | 535 Japanese categories |
| [owohai/kaomoji](https://github.com/owohai/kaomoji) | 5,255 | Emotions, actions, animals |
| [ekohrt/emoticon_kaomoji_dataset](https://github.com/ekohrt/emoticon_kaomoji_dataset) | 62,149 | Tagged emoticons |
| [frankunderwood-w/kaomoji_mcp_server](https://github.com/frankunderwood-w/kaomoji_mcp_server) | 75 | CLI-safe curated |

## opencode.json config

```json
{
  "mcp": {
    "kaomoji": {
      "type": "local",
      "command": ["node", "/path/to/kaomoji-mcp/index.js"],
      "enabled": true
    }
  }
}
```

## Rebuild database

```bash
# Requires Python 3.10+ and the cloned source repos in /tmp
python3 build-db.py
```

## License

MIT