Skip to main content
Glama

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.

npm version Glama


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-bag

Oder 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 build

Erzeugt 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:

  1. --bling <path> CLI-Argument (höchste Priorität)

  2. BLING_PATH Umgebungsvariable

  3. ./bling.json im 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 String

  • personality.tone, personality.formality, personality.humor — nicht leere Strings

  • theme.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 identity

Tool-Referenz

Tool

Lesen/Schreiben

Idempotent

Beschreibung

get_identity

lesen (Festplatte)

ja

Gibt die konfigurierte bling.json-Identität zurück

get_theme_for_platform

lesen (Festplatte)

ja

Plattform-formatiertes Styling. Argumente: platform ∈ {terminal, web, slack, discord, ide}

roll_identity

mutiert In-Memory-Cache

nein

Generiert einen zufälligen WOW-Charakter mit Seltenheitsbewertung

save_last_roll

schreiben (Festplatte)

nein

Speichert den letzten Wurf dauerhaft in bling.json (erstellt zuerst <path>.bak)

get_rarity_report

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 review

Entwicklung

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 changes

Inspektions-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 target

Projektlayout

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 plans

Lizenz

MIT

Available Tools

5 tools
get_identityGet Bot IdentityA
Read-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 ReportA
Read-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 PlatformA
Read-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.jsonA
Destructive

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

    A4.6/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      C
      maintenance
      MCP 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.
      10
      1
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      An 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.
      7
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      One 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.
      23
      4
      MIT