Skip to main content

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:

uvx emocean-mcp

Option 2: pip Install

pip install emocean-mcp
emocean-mcp

Option 3: Local Development

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:

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

Usage with Claude Code

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 for full project details.

Metadata

Release files for emocean-mcp 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for emocean-mcp 1.0.1
File Size Uploaded Provenance
emocean_mcp-1.0.1.tar.gz 6.3 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for emocean-mcp 1.0.1
File Interpreter ABI Platform
emocean_mcp-1.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 17.9 kB

Release files / emocean_mcp-1.0.1.tar.gz

Download URL emocean_mcp-1.0.1.tar.gz
Size 6.3 kB
Tags Source
SHA-256 checksum
How to use checksums
9751598f3c6be2de0c4ad922fb42128901b19b35c498a59fbf549c15e46944bf
BLAKE2b-256 checksum
How to use checksums
5d38076910d7fd9e142983cc383353ed546423bd5035ba6e1c623b133a269f80
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.11

Release files / emocean_mcp-1.0.1-py3-none-any.whl

Download URL emocean_mcp-1.0.1-py3-none-any.whl
Size 11.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1cdb14652900e4585605386884e8fb1ca2f0e9a8c0605c958db6fc8f36d6b7c7
BLAKE2b-256 checksum
How to use checksums
e4f30298a45f597a267770ee941d45a78da9d2e1a88784edd08f51b3d6db6aa8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.11

Security for emocean-mcp 1.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page