Same Energy

An MCP server for same.energy — the CLIP-based visual search engine by Jacob Jackson. Search images by vibe (text description, visual similarity, or both) straight from Claude Code, Claude Desktop, or any MCP client.

Great for moodboards, creative direction, and reference hunting: describe a mood, walk the similarity graph from a strong hit, download the keepers.

Tools

Tool	What it does
search(text, image_ids, n, nsfw)	Search by vibe. Text and/or comma-separated image ids — combinable to steer similarity ("images like these, but as architecture").
search_by_local_image(file_path, text, n, nsfw)	Upload a local image, get visually similar images back. Optional text steers the results.
image_info(image_ids)	Full metadata: dimensions, title, source platform, post URL, original URL.
download_images(image_ids, dest_dir, thumbnails)	Save full-size images (or thumbnails) locally. Defaults to ~/Downloads/same-energy/.

Since same.energy is CLIP-based, semantic descriptions beat keywords: grainy 35mm alpine trail at golden hour works much better than mountain.

Install

Requires uv (the script declares its own dependencies via PEP 723 — no venv or pip install needed).

git clone https://github.com/spxrtiat111/same-energy-mcp.git

Claude Code:

claude mcp add --scope user same-energy -- uv run --script /path/to/same-energy-mcp/same_energy_mcp.py

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "same-energy": {
      "command": "uv",
      "args": ["run", "--script", "/path/to/same-energy-mcp/same_energy_mcp.py"]
    }
  }
}

(If the app can't find uv, use its absolute path as command, e.g. ~/.local/bin/uv.)

No API key — same.energy's API is public and unauthenticated.

Sanity check (hits the live API):

uv run --script same_energy_mcp.py --selftest

How it works

same.energy has no documented API, so this server uses the same endpoints the website itself calls (reverse-engineered from its JS bundles):

• GET https://imageapi.same.energy/search?text=...&i=id1,id2&n=N — returns an NDJSON stream (progress lines, then a success payload)
• GET /image_info?i=..., GET /image?id=... (full-size file)
• PUT /upload?length=SIZE with raw image bytes — returns a sha1 id usable in similarity searches
• Thumbnails served from blobcdn.same.energy

Caveat: it's an unofficial API — it can change or disappear without notice. Be a good citizen: this is meant for interactive creative work, not bulk scraping.

License

MIT — see LICENSE. Not affiliated with same.energy; all images belong to their respective owners (results include source/post URLs for attribution).