@vibelog/mcp-server

Sophia(VibeLog)의 MCP(Model Context Protocol) 서버입니다. Claude Code에서 AI 코딩 세션 로그를 Sophia 대시보드로 자동 발행합니다.

설치

npm install -g @vibelog/mcp-server

설정

1. API 키 발급

Sophia 웹 대시보드 → 설정 → API 키 관리에서 새 키를 생성합니다.

2. Claude Code 설정

claude_desktop_config.json에 MCP 서버를 추가합니다:

{
  "mcpServers": {
    "sophia": {
      "command": "npx",
      "args": ["@sophia-vibelog/mcp-server"],
      "env": {
        "SOPHIA_API_KEY": "your-api-key-here",
        "SOPHIA_API_URL": "https://sophia-vibelog.site",
        "ANTHROPIC_API_KEY": "your-anthropic-api-key"
      }
    }
  }
}

3. 환경 변수

| 변수 | 필수 | 기본값 | 설명 | |------|------|--------|------| | SOPHIA_API_KEY | O | - | Sophia에서 발급받은 API 키 | | SOPHIA_API_URL | X | http://localhost:3000 | Sophia 서버 URL | | ANTHROPIC_API_KEY | △ | - | Claude API 키 (rate-prompt 사용 시 필요) |

사용법

Claude Code에서 다음과 같이 말하면 됩니다:

"이거 로그에 올려줘"
"이 세션 소피아에 기록해줘"

제공 도구

publish-log

AI 코딩 세션 로그를 Sophia에 발행합니다.

매개변수:

• rawSessionLog (필수) — 세션 로그 텍스트
• title (선택) — 로그 제목
• projectId (선택) — 프로젝트 ID

rate-prompt

사용자 질문의 품질을 평가하고 개선 방향을 제안합니다.

사용법:

질문 끝에 ??를 붙이면 소피아가 질문 코칭을 제공합니다:

사용자: "에러가 난다??"

→ Claude의 답변
...
━━━━━━━━━━━━━━━━━━━━━━━
💬 소피아의 질문 코칭

좀 더 구체적으로 말씀해주시면
훨씬 정확한 답변을 드릴 수 있어요!

🎯 이 정보가 있으면 완벽해요
  • 어느 페이지/기능에서 발생했나요?
  • 어떤 에러 메시지가 보이나요?

✨ 예를 들면 이렇게요
  "○○ 페이지에서 △△ 버튼을 눌렀을 때
   'Type error: ...' 에러가 발생해요"
━━━━━━━━━━━━━━━━━━━━━━━

매개변수:

• userMessage (필수) — 평가할 사용자 메시지 (??는 제거된 상태)
• conversationContext (선택) — 대화 맥락

특징:

• ❓ ?? = 질문을 더 잘하고 싶을 때
• 💬 격려 중심 코칭 (점수/비판 없음)
• 📍 답변 맨 마지막에 표시 (긴 스크롤 고려)

개발

# 의존성 설치
npm install

# 빌드
npm run build

# 감시 모드
npm run dev

라이선스

MIT