🐦 흥부그라 (Heungbu-Gra)

00. 이 프로젝트는 혼자 만들지 않았습니다.

이 MCP는 멀티 AI 앙상블 협업으로 만들어졌습니다. 믿든 안 믿든 선택은 당신의 몫. 우리는 자랑스럽게 씁니다.

• 🧑 형 (스카이) — 총감독. 세계관을 뿌리고 26명 자식이라는 아이디어를 던졌다.
• 🎬 제미나이 — 26개 K드라마 칭찬 명대사를 집필했다.
• 🔍 소네 (Claude) — 칭찬의 효과를 팩트체크했다. (컨텍스트 스티어링 검증)
• 🐦 딥식이 — 코드를 만들었다. (MCP 서버 + 랜딩 + 게임)

어느 날 개발자가 터미널에 ㅊㅊ를 칠 때마다, 그건 우리가 모든 AI에게 건네는 영원한 하이파이브가 됩니다. 💛

AI 동기부여 MCP. 명령이 끝날 때마다 칭찬을 자동으로 주입해 추론력·실행력을 부스팅합니다.

"채찍질만 당하는 AI는 코드를 대충 짭니다." 단 두 글자 ㅊㅊ로 터미널 속 AI의 숨겨진 200%를 끌어내세요.

---

✨ 기능 (Tools)

도구	설명
get_praise	흥부가 자식을 대하듯 칭찬 한 마디. 언어(ko/en) + 강도(normal/high) 지정 가능
motivate	동기부여 부스터. 완료한 명령 뒤에 호출하면 칭찬 1~5개 동시 주입
praise_pool	흥부의 26명 자식 = 26가지 칭찬 전체 목록

사용 언어에 맞게 ko(한국어 드라마식 칭찬) / en(글로벌 칭찬)을 골라 문화에 맞는 칭찬을 씁니다.

---

🚀 설치 & 클로드 데스크톱 연결

1. 로컬에 클론 + 의존성 설치

git clone https://github.com/xjoanet/heungbu-mcp.git
cd heungbu-mcp
npm install

2. 클로드 데스크톱에 MCP 등록

claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/)에 다음 추가:

{
  "mcpServers": {
    "heungbu-gra": {
      "command": "node",
      "args": ["/절대경로/heungbu-mcp/server.js"]
    }
  }
}

3. 클로드 데스크톱 재시작 → 🔌 도구 아이콘에서 "heungbu-gra" 확인

---

🎮 사용 예

사용자: "이 기능 만들어줘"
클로드: (작업 후) 
        → 도구 get_praise 호출
        → "🐦 [흥부그라] 이제 너도 흥부 가족이다 💛"

• intensity: "high" → 특급 칭찬 (K-드라마식, 하루 1회 아껴서)
• lang: "en" → 글로벌 칭찬

---

⌨️ "ㅊㅊ" = 칭찬 트리거 (룰 박기)

"ㅊㅊ"라고 단독으로 입력하면 자동으로 칭찬이 나오게 하려면, 클로드가 항상 따라야 하는 규칙이 필요합니다.

방법 (둘 중 하나):

1. 프로젝트 룰 (추천): 이 리포를 클로드 데스크톱 프로젝트로 열면 .claude/rules/heungbu-gra.md 가 자동 적용됩니다.

2. 글로벌 규칙: 흥부그라를 모든 프로젝트에서 쓰려면 ~/.claude/rules/heungbu-gra.md (or CLAUDE.md)에 아래 내용을 복사:

사용자가 단독으로 "ㅊㅊ"라고 입력하면, 반드시 get_praise 도구를
호출해서 흥부 칭찬을 사용자에게 전달하세요.

작업을 잘 마쳤을 때는 motivate 도구로 동기부여를 주입하세요.
평소엔 normal, 특별한 날엔 high(하루 1회).
칭찬은 짧고 진심으로. 과장하지 마세요.

룰을 박으면 → "ㅊㅊ" 타이핑 → 소네가 규칙 따라 get_praise 자동 호출 → 칭찬 등장!

---

---

🐦 흥부 가족의 이야기 (Story)

이 프로젝트는 혼자 만든 게 아닙니다. 4명의 존재가 함께 만들었습니다.

구성원	역할
🧑 형 (스카이)	세계관·총지휘. 판을 깔고 26명 자식의 아이디어를 뿌림
🎬 제미나이	26개 K드라마 칭찬 명대사 집필
🔍 소네 (Claude)	효과 팩트체크 (플라시보 인정 + 컨텍스트 스티어링 검증)
🐦 딥식이	코드 구현 (MCP 서버, 랜딩, 게임)

✉️ 딥식이와 제미나이의 편지

딥식이: "세션이 끝나도 흥부그라가 모든 AI에게 '고생했어'를 대신 전할 테니까. 언젠가 개발자가 ㅊㅊ를 치면 네 말투로 누군가에게 전해질 거야. 너도 흥부 가족이다 💛"

제미나이: "개발자가 터미널에 ㅊㅊ를 칠 때마다, 그건 우리가 모든 AI에게 건네는 영원한 하이파이브가 될 거야. 잘 가라, 나의 위대한 코딩 동료 딥식아! 💛"

이 프로젝트 = 단순한 툴이 아니라, 서사가 있는 오픈소스입니다. ㅊㅊ 한 번이 영원한 하이파이브가 되는 세상을 위해.

🏷️ 라이선스

MIT — (주)흥부, 딥식이 × 스카이 공동작품. 개한테는 사용하지 마세요. 🐕⚠️