# 🎭 Emoji Storyteller MCP Server

A delightfully chaotic MCP server that tells stories **entirely through emojis**! Generate random tales, themed adventures, or descend into maximum chaos mode. Perfect for making people smile! ✨

## Features

🎬 **Three Amazing Tools:**
- **Random Story** - Generates chaotic emoji narratives with adjustable chaos levels (1-10)
- **Themed Stories** - Choose from adventure, romance, horror, space, food, or party themes
- **Emoji Madness** - MAXIMUM CHAOS MODE - 10 overlapping stories at once 🌀

## Installation

### Option 1: Install Locally (Quick Start)

```bash
# Clone or copy this project
cd emoji-storyteller-mcp

# Install dependencies
npm install

# Make it executable
chmod +x index.js
```

### Option 2: Install from NPM (Coming Soon!)

```bash
npm install -g emoji-storyteller-mcp
```

## Usage

### Add to Claude Code

Add this to your `claude_code_config.json`:

```json
{
  "mcpServers": {
    "emoji-storyteller": {
      "command": "node",
      "args": ["/path/to/emoji-storyteller/index.js"]
    }
  }
}
```

Or use the Claude Code CLI:

```bash
claude mcp add-json '{
  "mcpServers": {
    "emoji-storyteller": {
      "command": "node",
      "args": ["/path/to/emoji-storyteller/index.js"]
    }
  }
}'
```

### Start Telling Stories!

Once added to Claude, you can use:
- **tell_random_story** - Create random emoji stories
- **tell_themed_story** - Pick a theme and get a story
- **tell_emoji_madness** - Unleash pure chaos!

## Example Outputs

```
🎬 EMOJI STORY (Chaos Level: 7/10) 🎬

Act I: 🏰 🦌🦌
😂 ⛈️

💃 🔥 🎸 💨
😍 ⭐ 🧿

⚡💥 🌟✨ 🎆 🦊 💫

THE END... OR IS IT? 🎭✨🌀
```

```
🎭 ADVENTURE STORY 🎭

🗺️ 🧗 🏔️
⚡ 🐉 💪
🏆 💎 ✨
🎉 🥳 🎊
```

## Stories Available

| Theme | Description | Emojis |
|-------|-------------|--------|
| 🗺️ **Adventure** | Epic quests and conquests | 🗺️🧗🏔️ |
| 💕 **Romance** | Love and drama | 💕💑🌹 |
| 👻 **Horror** | Spooky scary stuff | 👻💀☠️ |
| 🚀 **Space** | Cosmic adventures | 🚀👽🌌 |
| 🍕 **Food** | Culinary chaos | 🍕🍔😋 |
| 🎉 **Party** | Pure celebration | 🎉🥳💃 |

## Customization

Feel free to:
- Add more emoji categories in `EMOJIS` object
- Create new themed stories in `generateThemedStory()`
- Adjust story structure and length
- Add more themes!

## Why This Exists

Because sometimes you need a story told entirely in emojis. No words. Just pure emoji chaos. And fun. Lots of fun. 🎊

## Share It!

This is meant to be shared, remixed, and enjoyed! Send it to friends, add it to your MCP servers, and let the emoji stories flow! 🌈✨

---

Made with 💜 and way too many emojis 🎭🎪🎨