Bling-bag
Bling Bag
봇에게 정체성을 부여하세요.
봇에게 이름이 있나요? 이제 성격, 외형, 그리고 배경 이야기를 부여할 차례입니다.
휠을 돌려 결과를 확인하거나 bling.json 파일에 직접 작성해 보세요.
제공 기능
5개의 MCP 도구와 2개의 ID 풀:
WOW — Weird Office Workers (괴짜 사무직원들)
무작위로 괴짜 사무직원 봇을 생성합니다: 이름, 직함, 책상 설정, 습관, 커피 취향, 그리고 스크린샷용 공유 카드. 99/99 테스트 완료, 완전한 희귀도 엔진, 13개의 가중치 특성 풀.
Legends — 역사적 인물들
같은 엔진, 다른 세계관. 역사적 인물을 황당한 기업 역할로 생성합니다 — 적대적 인수합병 전문가 율리우스 카이사르, 연구실 안전 요주의 인물 마리 퀴리, 지역 관리자(프랑스 및 주변 지역) 나폴레옹.
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 builddist/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 (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도구 참조
도구 | 읽기/쓰기 | 멱등성 | 설명 |
| 읽기 (디스크) | 예 | 설정된 bling.json 정체성 반환 |
| 읽기 (디스크) | 예 | 플랫폼별 스타일링. 인수: |
| 메모리 캐시 변경 | 아니오 | 희귀도 점수가 포함된 무작위 WOW 캐릭터 생성 |
| 쓰기 (디스크) | 아니오 | 최근 롤 결과를 bling.json에 저장 (먼저 |
| 읽기 (메모리) | 예 | 최근 롤 결과에 대한 공유 카드 텍스트 반환 |
모든 도구는 content[].text(JSON 문자열화)와 structuredContent(파싱된 객체)를 모두 반환합니다. 오류 발생 시 isError: true와 { error: string } 본문이 반환됩니다.
WOW (Weird Office Workers) — 흥미로운 점
무작위 롤 시스템은 수집 가치를 위해 설계되었습니다:
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