Bling-bag
Bling Bag
给你的机器人一个身份。
你的机器人有名字了。现在给它一个个性、外观和背景故事吧。
转动转盘看看你会得到什么——或者在 bling.json 文件中编写你自己的内容。
你将获得什么
五个 MCP 工具和两个身份池:
WOW — 怪异办公室员工 (Weird Office Workers)
随机生成一个古怪的办公室机器人:名字、职位、办公桌设置、习惯、咖啡仪式以及一张可直接截图的分享卡片。99/99 测试通过,完整的稀有度引擎,13 个加权特征池。
Legends — 历史人物
同样的引擎,不同的宇宙。生成一个处于荒谬企业角色中的历史人物——尤利乌斯·凯撒作为恶意收购专家,玛丽·居里作为实验室安全通缉犯,拿破仑作为区域经理(法国及周边地区)。
将 variant: "legends" 传递给 roll_identity 即可使用。默认为 "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 配置路径:
--bling <path>CLI 参数(最高优先级)BLING_PATH环境变量服务器工作目录中的
./bling.json(默认)
bling.json — 机器人的身份文件
需要三个字段:name、personality(包含 tone、formality、humor)和 theme(包含作为 #RRGGBB 十六进制字符串的 primary_color 和 accent_color)。
最小示例
{
"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工具参考
工具 | 读/写 | 幂等性 | 描述 |
| 读取(磁盘) | 是 | 返回已配置的 bling.json 身份 |
| 读取(磁盘) | 是 | 平台格式化的样式。参数: |
| 修改内存缓存 | 否 | 生成一个带有稀有度评分的随机 WOW 角色 |
| 写入(磁盘) | 否 | 将最近一次滚动结果持久化到 bling.json(先创建 |
| 读取(内存) | 是 | 返回最近一次滚动结果的分享卡片文本 |
所有工具都返回 content[].text(JSON 字符串化)和 structuredContent(解析后的对象)。错误将以 isError: true 和 { error: string } 主体返回。
WOW (怪异办公室员工) — 有趣之处
随机滚动系统专为可收藏性而构建:
13 个加权池,465 个条目 — 名字、职位、习惯、咖啡仪式、身高、配饰等。
每个池 5 个稀有度等级 — 普通 (50%)、罕见 (30%)、稀有 (15%)、传说 (4%)、神话 (1%)
5 个角色等级,根据稀有度分数计算:
归档员 (50% 的滚动结果)
团队主管 (30%)
中层经理 (14%)
高管 (5%)
人力资源部警告过我们 (1%)
命名主体 — 手工创作的 1-of-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/ 下的两个 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 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