Skip to main content
Glama

Bling Bag

ボットにアイデンティティを与えましょう。

あなたのボットには名前があります。次は、性格、外見、そして背景ストーリーを与えてみませんか。

ホイールを回して何が出るか試すか、bling.jsonファイルで独自に作成することもできます。

npm version Glama


何ができるか

5つのMCPツールと2つのアイデンティティプールを提供します:

WOW — Weird Office Workers(奇妙なオフィスワーカー)

名前、役職、デスク環境、習慣、コーヒーの儀式、そしてスクリーンショット映えする共有カードを備えた、風変わりなオフィスワーカーボットをランダムに生成します。99/99のテスト済み、完全なレアリティエンジン、13の重み付けされた特性プールを搭載。

Legends — Historical Figures(歴史上の人物)

エンジンは同じですが、世界観が異なります。歴史上の人物を不条理な企業役職に当てはめます。例えば、敵対的買収のスペシャリストとしてのユリウス・カエサル、ラボの安全管理で指名手配中のマリー・キュリー、地域マネージャー(フランスおよび周辺地域担当)としてのナポレオンなどです。

roll_identityにvariant: "legends"を渡すと使用できます。デフォルトは"wow"です。


Related MCP server: PLTM-Claude

インストール

前提条件

  • Node.js 20以降

  • MCP互換クライアント(Claude Code、Claude Desktop、Codex、Cursorなど)

パッケージの追加

npm install bling-bag

または、インストールせずにオンデマンドで実行することも可能です。MCPクライアントはnpx bling-bag経由で直接起動できます(以下のクライアント設定を参照)。

開発用(ソースコードを修正する場合)

git clone https://github.com/tjclaude88/mcp-bling.git
cd mcp-bling
npm install
npm run build

dist/index.jsに実行可能なサーバーが生成されます。

MCPクライアントへの組み込み

このサーバーはstdioトランスポートを使用します。クライアントはネットワークポート経由ではなく、子プロセスとしてサーバーを起動します。

Claude Code

Claude CodeのMCP設定に追加します(場所はバージョンによって異なります):

{
  "mcpServers": {
    "bling": {
      "command": "npx",
      "args": ["-y", "bling-bag"],
      "env": {
        "BLING_PATH": "/absolute/path/to/your/bling.json"
      }
    }
  }
}

npx -y bling-bagは、個別のインストール手順を必要とせずに最新バージョンをダウンロードして実行します。

Claude Desktop

同様に、claude_desktop_config.jsonに記述します:

{
  "mcpServers": {
    "bling": {
      "command": "npx",
      "args": ["-y", "bling-bag"],
      "env": {
        "BLING_PATH": "/absolute/path/to/your/bling.json"
      }
    }
  }
}

バージョンの固定(本番環境で推奨)

将来のリリースが自動的に適用されるのを防ぐため、特定のバージョンを固定します:

"args": ["-y", "bling-bag@0.1.0"]

開発モードでの起動(ローカルクローンから)

リポジトリをクローンし、dist/から直接実行したい場合は以下を使用します:

"command": "node",
"args": ["/absolute/path/to/mcp-bling/dist/index.js"]

BLING_PATHが設定されていない場合、サーバーは作業ディレクトリ内の./bling.jsonを探します。

設定の解決順序

サーバーは以下の順序でbling設定パスを解決します:

  1. --bling <path> CLI引数(最優先)

  2. BLING_PATH 環境変数

  3. サーバーの作業ディレクトリ内の./bling.json(デフォルト)


bling.json — ボットのアイデンティティファイル

3つのフィールドが必須です:name、personality(tone、formality、humorを含む)、および**theme**(primary_colorとaccent_colorを#RRGGBBの16進数文字列で指定)。

最小構成例

{
  "name": "Pixel",
  "personality": {
    "tone": "warm",
    "formality": "casual",
    "humor": "playful"
  },
  "theme": {
    "primary_color": "#3A7BD5",
    "accent_color": "#FFD166"
  }
}

完全な例(すべてのオプションセクションを含む)

{
  "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"
  }
}

検証ルール

  • name — 空ではない文字列

  • personality.tone, personality.formality, personality.humor — 空ではない文字列

  • theme.primary_color, theme.accent_color — ^#[0-9A-Fa-f]{6}$に一致する必要がある(短縮形の#RGBや#の欠落は不可)

検証エラーはisError: trueとして返され、構造化された{ error: "..." }ボディに欠落または不正なフィールド名が含まれるため、エージェントが自己修正可能です。


一般的なエージェントフロー

フローA — 設定されたアイデンティティを採用する

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.)

フローB — 新しいランダムなアイデンティティを生成する

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

ツールリファレンス

ツール

読み取り/書き込み

冪等性

説明

get_identity

読み取り (ディスク)

はい

設定されたbling.jsonのアイデンティティを返す

get_theme_for_platform

読み取り (ディスク)

はい

プラットフォーム用にフォーマットされたスタイル。引数: platform ∈ {terminal, web, slack, discord, ide}

roll_identity

メモリ内キャッシュを更新

いいえ

レアリティスコア付きのランダムなWOWキャラクターを生成する

save_last_roll

書き込み (ディスク)

いいえ

直近のロール結果をbling.jsonに保存する(先に<path>.bakを作成)

get_rarity_report

読み取り (メモリ内)

はい

直近のロール結果の共有カードテキストを返す

すべてのツールはcontent[].text(JSON文字列化)とstructuredContent(解析済みオブジェクト)の両方を返します。エラーはisError: trueと{ error: string }ボディで返されます。


WOW (Weird Office Workers) — 興味深い理由

ランダムロールシステムは収集性を考慮して構築されています:

  • 13の重み付けされたプール、465エントリ — 名前、役職、習慣、コーヒーの儀式、身長、アクセサリーなど。

  • プールごとに5つのレアリティ帯 — コモン (50%)、アンコモン (30%)、レア (15%)、レジェンダリー (4%)、ミシック (1%)

  • レアリティスコアから計算される5つのキャラクターティア:

    • ファイリング事務員 (ロールの50%)

    • チームリーダー (30%)

    • ミドルマネージャー (14%)

    • C-Suite(経営層) (5%)

    • 人事部から警告を受けた者 (1%)

  • 名前付き被験者 — 手書きの1点物キャラクターが約0.5%の確率で出現し、常に「人事部から警告を受けた者」に分類されます。

  • HOMUNCULUSフレーム — すべてのロール結果は、被験者ID、コホート(曜日)、ティア、取り込み日、フラグ(例: 連絡禁止)を含む機密文書風の共有カードでラップされます。

分布は経験的にテストされており、tests/mystery_box.test.tsでの1万回のロールテストにより、仕様目標に対して±2ppの許容範囲が強制されています。

出力例

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

開発

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

検査スクリプト

scripts/配下の2つのNode ESMヘルパーを使用すると、MCPサーバーを起動せずにWOWエンジンを検査できます(これらはクローンされたリポジトリにのみ含まれており、npm install bling-bagパッケージには同梱されていません):

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

プロジェクト構成

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

ライセンス

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