Bling-bag
Bling Bag
Verleihe deinem Bot eine Identität.
Dein Bot hat einen Namen. Jetzt gib ihm eine Persönlichkeit, ein Aussehen und eine Hintergrundgeschichte.
Dreh am Rad und schau, was du bekommst – oder schreibe deine eigene in einer bling.json-Datei.
Was du bekommst
Fünf MCP-Tools und zwei Identitäts-Pools:
WOW — Weird Office Workers
Erwürfle einen zufälligen, schrulligen Büro-Bot: Name, Berufsbezeichnung, Schreibtisch-Setup, Gewohnheiten, Kaffeeritual und eine Screenshot-fertige Share-Card. 99/99 Tests, vollständige Seltenheits-Engine, 13 gewichtete Merkmals-Pools.
Legends — Historische Persönlichkeiten
Dieselbe Engine, anderes Universum. Erwürfle eine historische Persönlichkeit in einer absurden Unternehmensrolle — Julius Caesar als Spezialist für feindliche Übernahmen, Marie Curie als meistgesuchte Person der Laborsicherheit, Napoleon als Regionalmanager (Frankreich & Umgebung).
Übergib variant: "legends" an roll_identity, um dies zu nutzen. Der Standardwert ist "wow".
Related MCP server: PLTM-Claude
Installation
Voraussetzungen
Node.js 20 oder neuer
Ein MCP-kompatibler Client (Claude Code, Claude Desktop, Codex, Cursor, etc.)
Das Paket hinzufügen
npm install bling-bagOder führe es bei Bedarf aus, ohne es zu installieren — MCP-Clients können es direkt über npx bling-bag starten (siehe Client-Konfiguration unten).
Für die Entwicklung (Änderung des Quellcodes)
git clone https://github.com/tjclaude88/mcp-bling.git
cd mcp-bling
npm install
npm run buildErzeugt einen ausführbaren Server unter dist/index.js.
In deinen MCP-Client einbinden
Der Server verwendet den stdio-Transport — Clients starten ihn als untergeordneten Prozess, nicht über einen Netzwerk-Port.
Claude Code
Füge dies zu deiner Claude Code MCP-Konfiguration hinzu (der Speicherort variiert je nach Version):
{
"mcpServers": {
"bling": {
"command": "npx",
"args": ["-y", "bling-bag"],
"env": {
"BLING_PATH": "/absolute/path/to/your/bling.json"
}
}
}
}npx -y bling-bag lädt die neueste Version herunter und führt sie aus, ohne dass ein separater Installationsschritt erforderlich ist.
Claude Desktop
Gleiches Format, in claude_desktop_config.json:
{
"mcpServers": {
"bling": {
"command": "npx",
"args": ["-y", "bling-bag"],
"env": {
"BLING_PATH": "/absolute/path/to/your/bling.json"
}
}
}
}An eine Version pinnen (empfohlen für die Produktion)
Um zu vermeiden, dass zukünftige Releases automatisch übernommen werden, pinne eine bestimmte Version:
"args": ["-y", "bling-bag@0.1.0"]Aufruf im Entwicklermodus (aus einem lokalen Klon)
Wenn du das Repo geklont hast und direkt aus dist/ ausführen möchtest, verwende:
"command": "node",
"args": ["/absolute/path/to/mcp-bling/dist/index.js"]Wenn BLING_PATH nicht gesetzt ist, sucht der Server nach ./bling.json im Arbeitsverzeichnis.
Reihenfolge der Konfigurationsauflösung
Der Server löst den Pfad zur Bling-Konfiguration in dieser Reihenfolge auf:
--bling <path>CLI-Argument (höchste Priorität)BLING_PATHUmgebungsvariable./bling.jsonim Arbeitsverzeichnis des Servers (Standard)
bling.json — die Identitätsdatei des Bots
Drei Felder sind erforderlich: name, personality (mit tone, formality, humor) und theme (mit primary_color und accent_color als #RRGGBB Hex-Strings).
Minimalbeispiel
{
"name": "Pixel",
"personality": {
"tone": "warm",
"formality": "casual",
"humor": "playful"
},
"theme": {
"primary_color": "#3A7BD5",
"accent_color": "#FFD166"
}
}Vollständiges Beispiel (mit allen optionalen Abschnitten)
{
"name": "Brenda from Accounts",
"personality": {
"tone": "polite",
"formality": "professional",
"humor": "dry",
"catchphrase": "Per my last email"
},
"physical": {
"species": "human",
"height": "permanently mid-sigh",
"accessory": "a lanyard with 14 badges of varying importance",
"expression": "polite disappointment",
"material": "a cardigan, at least one"
},
"office": {
"job_title": "ASCII Comptroller",
"desk_setup": "a coffee mug labelled WORLD'S OKAYEST DBA",
"habit": "microwaves fish despite three separate HR warnings",
"coffee_ritual": "black coffee, no nonsense",
"meeting_energy": "always 4 minutes late, always with a reason",
"passive_aggressive": "Per my last email"
},
"theme": {
"primary_color": "#9C6B3A",
"accent_color": "#D9D9D9"
},
"homunculus": {
"subject_id": "0147",
"cohort": "Tuesday",
"classification": "Middle Manager",
"ingested": "2025-07-14",
"flag": "flagged for review"
}
}Validierungsregeln
name— nicht leerer Stringpersonality.tone,personality.formality,personality.humor— nicht leere Stringstheme.primary_color,theme.accent_color— müssen^#[0-9A-Fa-f]{6}$entsprechen (kein Kurzformat#RGB, kein fehlendes#)
Validierungsfehler werden als isError: true mit einem strukturierten { error: "..." }-Body zurückgegeben, der das fehlende oder falsch formatierte Feld benennt — Agenten können sich selbst korrigieren.
Typische Agenten-Flows
Flow A — die konfigurierte Identität übernehmen
1. Call get_identity → receive name, personality, appearance, theme
2. Call get_theme_for_platform with platform="terminal" (or web/slack/discord/ide)
3. Use the returned styling in agent output (ANSI codes for headings, etc.)Flow B — eine neue zufällige Identität generieren
1. Call roll_identity → receive identity + rarity + framed share card
2. (Optional) Call get_rarity_report → receive just the framed share card again
3. Call save_last_roll → persists the rolled identity to bling.json (with .bak backup of any prior config)
4. Future calls to get_identity now return the rolled identityTool-Referenz
Tool | Lesen/Schreiben | Idempotent | Beschreibung |
| lesen (Festplatte) | ja | Gibt die konfigurierte bling.json-Identität zurück |
| lesen (Festplatte) | ja | Plattform-formatiertes Styling. Argumente: |
| mutiert In-Memory-Cache | nein | Generiert einen zufälligen WOW-Charakter mit Seltenheitsbewertung |
| schreiben (Festplatte) | nein | Speichert den letzten Wurf dauerhaft in bling.json (erstellt zuerst |
| lesen (In-Memory) | ja | Gibt den Share-Card-Text für den letzten Wurf zurück |
Alle Tools geben sowohl content[].text (als JSON-String) als auch structuredContent (das geparste Objekt) zurück. Fehler werden mit isError: true und einem { error: string }-Body zurückgegeben.
WOW (Weird Office Workers) — was es interessant macht
Das Zufallswürfel-System ist auf Sammelbarkeit ausgelegt:
13 gewichtete Pools, 465 Einträge — Namen, Berufsbezeichnungen, Gewohnheiten, Kaffeerituale, Größe, Accessoires usw.
5 Seltenheitsstufen pro Pool — Gewöhnlich (50%), Ungewöhnlich (30%), Selten (15%), Legendär (4%), Mythisch (1%)
5 Charakter-Stufen, berechnet aus dem Seltenheitswert:
Sachbearbeiter (50% der Würfe)
Teamleiter (30%)
Mittleres Management (14%)
Führungsebene (5%)
HR hat uns gewarnt (1%)
Benannte Subjekte — handgeschriebene 1-von-1-Charaktere erscheinen mit einer Wahrscheinlichkeit von ~0,5%, immer klassifiziert als "HR hat uns gewarnt"
HOMUNCULUS-Rahmen — jeder Wurf umschließt den Absatz in einer Share-Card für klassifizierte Dokumente mit Subjekt-ID, Kohorte (Wochentag), Stufe, Ingestionsdatum und einem Flag (z. B. Nicht kontaktieren)
Die Verteilung ist empirisch getestet: Ein 10.000-Würfe-Test in tests/mystery_box.test.ts erzwingt eine Toleranz von ±2 Prozentpunkten gegenüber dem Spezifikationsziel.
Beispielausgabe
HOMUNCULUS CORPUS · Subject 4483 · Cohort: Wednesday
Classification: Middle Manager · Rarity 94.5 · 80th percentile
Personnel record — Colin, Wizard of Light Bulb Moments. Distinguishing
features: a slightly-too-big blazer over a plain tee; a flip phone in
a belt holster; expression: patient disagreement. Notable behaviours:
clips their fingernails at the desk on Wednesday afternoons; a
kombucha SCOBY fermenting next to the keyboard; the kind to ask 'can
we park that?' without parking anything.
— RELATABILITY CORPUS v3.1 · ingested 2024-03-08 · flagged for reviewEntwicklung
npm install # install dependencies
npm run build # compile TypeScript → dist/
npm run dev # build then start the MCP server (stdio)
npm test # run all 94 tests once
npm run test:watch # re-run tests on file changesInspektions-Skripte
Zwei Node ESM-Helfer unter scripts/ ermöglichen es dir, die WOW-Engine zu inspizieren, ohne den MCP-Server zu starten (diese sind nur in einem geklonten Repo enthalten — sie werden nicht im npm install bling-bag-Paket mitgeliefert):
node scripts/show-rolls.mjs 8 2026 # print 8 framed share cards (seed=2026)
node scripts/distribution-check.mjs 10000 # tally tiers across 10k rolls vs. spec targetProjektlayout
src/
index.ts # MCP server entry point (stdio transport)
identity.ts # bling.json loader + validator
tools.ts # MCP tool registrations
types.ts # shared TypeScript types
mystery_box.ts # WOW engine barrel + rollIdentity orchestrator
mystery_box/
rng.ts # seedable PRNG, weighted picker
pools.ts # 13 trait pools (465 entries)
scoring.ts # rarity score + tier thresholds
rendering.ts # paragraph templates + HOMUNCULUS frame
named.ts # hand-authored Named Subjects
tests/ # vitest test suites
scripts/ # dev-time inspection tools
docs/superpowers/ # design specs and implementation plansLizenz
MIT
Available Tools
5 toolsget_identityGet Bot IdentityARead-onlyIdempotent
Get the bot's full identity from bling.json — name, personality, quirks, appearance, and theme colours. Returns the configured identity (hand-written or saved from a roll). Errors if bling.json is missing or invalid.
Inputs: no named parameters.
get_rarity_reportGet WOW Rarity ReportARead-onlyIdempotent
Return the formatted share card (lore header, paragraph, lore footer) for the most-recent WOW roll. The report is plain text designed to be screenshotted directly. Errors if no roll has happened this session.
Inputs: no named parameters. Returns: report, error
get_theme_for_platformGet Theme for PlatformARead-onlyIdempotent
Get platform-specific styling for the bot. Supported platforms: terminal (returns ANSI escape codes), web (CSS variables), slack, discord, ide. Unknown platforms get the raw hex theme colours.
Inputs: platform (required).
roll_identityRoll a WOW IdentityA
WOW — Weird Office Workers. Roll a fresh random bot identity: a quirky office-worker character with a rarity score and a screenshot-ready share card. Stores the roll for save_last_roll and get_rarity_report.
Inputs: no named parameters. Returns: identity, rarity, paragraph, framed, +1 more
save_last_rollSave Last WOW Roll to bling.jsonADestructive
Persist the most-recent WOW roll by writing it to the configured bling.json path. If a file already exists at that path it is first copied to .bak so user-tuned configs are recoverable. Returns the backup path (or null if the target was new).
Inputs: no named parameters. Returns: ok, written_to, backup, error
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: get_identity retrieves a saved identity, get_rarity_report provides a formatted report of the latest roll, get_theme_for_platform returns platform-specific styling, roll_identity generates a new random identity, and save_last_roll persists the latest roll. There is no overlap in functionality, making tool selection straightforward for an agent.
All tool names follow a consistent verb_noun pattern with snake_case, such as get_identity, get_rarity_report, get_theme_for_platform, roll_identity, and save_last_roll. This uniformity enhances readability and predictability across the toolset.
With 5 tools, the server is well-scoped for managing bot identities and related operations. Each tool serves a specific role in the identity lifecycle, from creation to retrieval and persistence, without being overly sparse or bloated.
The toolset provides complete coverage for the bot identity domain: roll_identity for creation, get_identity and get_rarity_report for retrieval, save_last_roll for persistence, and get_theme_for_platform for styling. There are no obvious gaps, supporting full agent workflows from generation to configuration.
Maintenance
Related MCP Connectors
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Hosted MCP server for live public-data APIs and Skills for AI agents.
Shared memory and mail for your AI agents. Verified with Claude Code; other MCP clients in testing.
Related MCP Servers
- FlicenseAqualityCmaintenanceMCP server for Being — a Personality Runtime that gives AI agents persistent memory, personality, and relationships. Enables any MCP-compatible client (Claude, OpenClaw, Cursor, etc.) to connect with a Being that remembers, grows, and maintains its own identity across sessions.101-
- AlicenseNot gradedqualityCmaintenanceAn MCP server that gives Claude Desktop persistent memory, self-awareness, epistemic hygiene, and genuine agency across conversations with a typed memory system, embedding-based semantic search, a 3-judge memory jury, and a real-time dashboard.7MIT
- AlicenseAqualityDmaintenanceOne MCP that turns Claude Code into your whole dev stack by swallowing other MCP servers, delegating to Codex & Gemini on your CLI subscriptions, remembering projects in a searchable knowledge graph, and carrying setup across sessions — secret-free by design.234MIT
- AlicenseNot gradedqualityCmaintenanceServe your personal work-style manual as an MCP server so AI surfaces load the same single source of truth about your identity and preferences.MIT