distribea-mcp 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +61 -0
  2. package/index.mjs +2266 -0
  3. package/package.json +28 -0
package/README.md ADDED
@@ -0,0 +1,61 @@
1
+ # Distribea MCP
2
+
3
+ On-brand website imagery, generated straight into your codebase.
4
+
5
+ Plug this MCP into your coding tool (Claude Code, Cursor…) and every page you
6
+ build ships with **ultra-realistic, style-locked images**: one consistent art
7
+ direction across the whole site, recurring characters with the **same face in
8
+ every scene**, believable UGC-style avatars for review sections, plus logo,
9
+ favicon pack and og:image — all delivered as optimised WebP with proper ALT
10
+ text, patched directly into your code.
11
+
12
+ The heavy lifting (art direction, generation, billing) runs on the hosted
13
+ Distribea engine. This package is only the local connector: it scans and
14
+ patches **your** files, and contains no API keys and no secrets.
15
+
16
+ ## Setup
17
+
18
+ A [Distribea](https://distribea.com) subscription is required.
19
+
20
+ 1. Get your personal key on <https://distribea.com/account/mcp>
21
+ 2. Paste the ready-made block into the `.mcp.json` at the root of your project:
22
+
23
+ ```json
24
+ {
25
+ "mcpServers": {
26
+ "distribea-mcp": {
27
+ "command": "npx",
28
+ "args": ["-y", "distribea-mcp@latest"],
29
+ "env": {
30
+ "DISTRIBEA_MCP_KEY": "dmcp_…"
31
+ }
32
+ }
33
+ }
34
+ }
35
+ ```
36
+
37
+ 3. Build your pages with `<img src="https://placehold.co/1200x600">` markers,
38
+ then ask your agent for the images — one `make_images` call dresses the
39
+ whole page.
40
+
41
+ ## Tools
42
+
43
+ | Tool | What it does |
44
+ |---|---|
45
+ | `make_images` ⭐ | Fill every placeholder/stock slot of a page (or the whole project) with on-brand images, in parallel — or rebrand existing images in place (`rebrand: true`) |
46
+ | `generate_image` | One on-brand image (auto-switches to UGC selfie mode for review avatars) |
47
+ | `edit_image` | Retouch, redo, remove background, upscale ×4, extend |
48
+ | `site_style` | Lock, refine or anchor the site's visual identity |
49
+ | `brand_pack` | Logo + favicon pack + og:image in one call |
50
+ | `create_reference` | Lock a recurring character (real photo supported) or product |
51
+ | `finish_images` | Fix missing ALT texts + convert heavy images to WebP (free) |
52
+ | `pack_status` | Current style, characters, credits |
53
+
54
+ ## Notes
55
+
56
+ - Generations are billed in credits on your Distribea plan; every batch is
57
+ quoted in credits before it starts.
58
+ - Your project files never leave your machine except the specific images you
59
+ ask to edit.
60
+
61
+ © Distribea — <https://distribea.com>