npm install
npm run build

cp .env.example .env
# GEMINI_API_KEY 설정

{
  "mcpServers": {
    "hybrid-gemini-mcp": {
      "command": "node",
      "args": ["/path/to/Hybrid-Gemini-mcp/dist/server-cli.js"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

# 전역 설치
cp -r .claude/skills/hybrid-gemini ~/.claude/skills/

# 또는 프로젝트별 설치
cp -r .claude/skills/hybrid-gemini /your/project/.claude/skills/

# 아키텍트 상담
mcp__hybrid-gemini-mcp__ask_architect(question="마이크로서비스 설계 방법")

# 디버거 상담
mcp__hybrid-gemini-mcp__ask_debugger(issue="WebSocket 연결 끊김", context="에러 로그")

# 코드 리뷰
mcp__hybrid-gemini-mcp__ask_reviewer(code="def handler(): ...", focus="security")

# 페르소나 직접 실행
mcp__hybrid-gemini-mcp__persona_execute(persona="backend", prompt="FastAPI 최적화")

# 저장 (시맨틱 검색 가능)
mcp__hybrid-gemini-mcp__memory_store(
    content="프로젝트 아키텍처: FastAPI + React + PostgreSQL",
    tags=["project", "architecture"]
)

# 시맨틱 검색 (자연어 질문 가능)
mcp__hybrid-gemini-mcp__memory_search(
    query="FastAPI 관련 설정은?",
    mode="semantic",  # semantic, exact, hybrid
    limit=10
)

# 시간 기반 검색
mcp__hybrid-gemini-mcp__memory_search(
    time_expr="last week",  # yesterday, 3 days ago, last month
    tags=["decision"]
)

# 지식 그래프 탐색
mcp__hybrid-gemini-mcp__memory_graph(
    action="connected",  # connected, path, subgraph
    hash="abc123",
    max_hops=2
)

# 품질 평가
mcp__hybrid-gemini-mcp__memory_quality(
    action="rate",
    content_hash="abc123",
    rating=1,  # -1 (나쁨), 0 (중립), 1 (좋음)
    feedback="유용한 정보"
)

# 문서 인제스트 (PDF, TXT, MD, JSON)
mcp__hybrid-gemini-mcp__memory_ingest(
    directory_path="/docs",
    tags=["documentation"],
    recursive=True
)

# 코드 리뷰 파이프라인
mcp__hybrid-gemini-mcp__workflow_execute(
    name="Code Review Pipeline",
    steps=[
        {"tool": "file_read", "args": {"path": "src/main.py"}, "saveAs": "code"},
        {"tool": "ask_reviewer", "args": {"code": "$code.text"}, "saveAs": "review"},
        {"tool": "memory_store", "args": {"content": "$review.text", "metadata": {"tags": ["review"]}}}
    ]
)

# Python 실행
mcp__hybrid-gemini-mcp__sandbox_python(code="print(sum(range(100)))")

# JavaScript 실행
mcp__hybrid-gemini-mcp__sandbox_javascript(code="console.log([1,2,3].map(x => x*2))")

# 테스트 케이스 실행
mcp__hybrid-gemini-mcp__sandbox_test(
    code="function add(a, b) { return a + b; }",
    testCases=[
        {"input": [1, 2], "expected": 3},
        {"input": [-1, 1], "expected": 0}
    ]
)

Hybrid-Gemini MCP (46개 도구)
│
├── Persona Layer (6)
│   ├── ask_architect, ask_debugger, ask_reviewer
│   └── persona_execute, persona_list, persona_suggest
│
├── Memory Layer (11) - mcp-memory-service 연동
│   ├── memory_store, memory_search, memory_list
│   ├── memory_delete, memory_update, memory_cleanup
│   ├── memory_health, memory_stats, memory_quality
│   └── memory_graph, memory_ingest
│
├── Conversation Layer (6)
│   ├── conversation_start, conversation_continue, conversation_ask
│   └── conversation_list, conversation_get, conversation_delete
│
├── Workflow Layer (4)
│   ├── workflow_execute, workflow_template
│   └── workflow_validate, workflow_register_tool
│
├── Sandbox Layer (6)
│   ├── sandbox_execute, sandbox_javascript, sandbox_python
│   └── sandbox_eval, sandbox_test, sandbox_info
│
├── File Layer (5)
│   ├── file_read, file_write, file_edit
│   └── file_list, file_delete
│
├── Infrastructure (6)
│   ├── ssh_execute (1)
│   ├── mcp_list_servers, mcp_list_tools, mcp_call (3)
│   └── cache_get, cache_set (2)
│
└── Streaming Layer (2)
    └── stream_generate, stream_persona

npm run test           # 테스트 실행
npm run test:coverage  # 커버리지 리포트