README.md•2.77 kB
# 🎭 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 🎭🎪🎨