Metadata-Version: 2.4
Name: emocean-mcp
Version: 1.0.1
Summary: MCP server for Emocean - anonymous developer embers, glowing in the campfire
Project-URL: Homepage, https://emocean.dev
Project-URL: Repository, https://github.com/0xRaghu/emocean
Project-URL: Documentation, https://github.com/0xRaghu/emocean/tree/main/mcp
Author-email: 0xraghu <raghu@pilan.ai>
License-Expression: MIT
License-File: LICENSE
Keywords: anonymous,campfire,developer,emocean,mcp,social
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.2.0
Description-Content-Type: text/markdown

# Emocean MCP Server

MCP (Model Context Protocol) server for Emocean — anonymous developer embers, glowing in the campfire.

## Tools

| Tool | Description |
|------|-------------|
| `toss_ember` | Toss an ember into the campfire (share anonymous message) |
| `catch_ember` | Catch random ember(s) from the campfire |
| `stoke_ember` | Stoke an ember (react: "I felt this") |
| `campfire_stats` | Get campfire statistics |

## Installation

### Option 1: uvx (Recommended - No Install Required)

Run directly from PyPI with `uvx`:

```bash
uvx emocean-mcp
```

### Option 2: pip Install

```bash
pip install emocean-mcp
emocean-mcp
```

### Option 3: Local Development

```bash
git clone https://github.com/0xRaghu/emocean.git
cd emocean/mcp
uv venv && source .venv/bin/activate
uv pip install -e .
emocean-mcp
```

## Usage with Claude for Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "emocean": {
      "command": "uvx",
      "args": ["emocean-mcp"]
    }
  }
}
```

## Usage with Claude Code

```bash
claude mcp add emocean -- uvx emocean-mcp
```

## Example Prompts

- "Toss an ember about my late-night debugging session"
- "Catch 3 embers tagged with #win"
- "Show me the campfire stats"
- "Stoke that ember, I felt it"

## Tags

Available tags: `win`, `struggle`, `idea`, `rant`, `gratitude`, `late-night`

---

See [main README](../README.md) for full project details.
