# MCP 길잡이 (mcp-giljabi)

사용자의 요청에 맞는 PlayMCP를 찾아주는 MCP 서버입니다.

## 기능

- **find_mcp**: AI가 직접 분석하여 적합한 MCP를 추천합니다. 적합한 MCP가 없으면 "없다"고 알려줍니다.
- **add_mcp**: MCP 설치 방법을 안내합니다

## 동작 방식

```
사용자: "영화 정보 검색해줘"
         ↓
   Gemini 2.0 Flash가 MCP 목록 분석
         ↓
적합한 MCP 추천 + 선택 이유 설명
```

**장점:**
- 의도 파악이 정확함 ("심심해" → 게임/영화 추천)
- 없는 기능은 "없다"고 명확히 답변 ("주식 정보" → 해당 MCP 없음)
- 임베딩 계산/캐싱 불필요

## 사전 요구사항

1. **Node.js** (v18 이상)
2. **Google Gemini API Key** (무료)

## 설치

```bash
cd mcp-giljabi
npm install
```

## 환경 변수 설정

```bash
cp .env.example .env
# .env 파일에 GEMINI_API_KEY 설정
```

Gemini API Key 발급: https://aistudio.google.com/app/apikey

## 빌드

```bash
npm run build
```

## 실행

```bash
npm start
```

## 로컬 테스트 방법

### 1. 검색 기능 테스트

```bash
GEMINI_API_KEY=your-api-key npm run test-search
```

### 2. MCP Inspector로 테스트

```bash
npm run build
GEMINI_API_KEY=your-api-key npm run inspector
# http://localhost:5173 접속
```

### 3. Claude Desktop에서 로컬 테스트

`~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "mcp-giljabi": {
      "command": "node",
      "args": ["/path/to/mcp-giljabi/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}
```

## 사용 예시

### find_mcp - 결과 있음

```
입력: "영화 정보를 검색하고 싶어"

출력:
🔍 "영화 정보를 검색하고 싶어" 검색 결과 (3개)

1. **Movie Digging**
   📝 TMDb API를 활용하여 영화 정보를 검색하고 추천합니다
   💡 사용자가 영화 정보 검색을 원하므로 가장 적합
   👤 개발자: 최용태
   📈 관련도: 95%
```

### find_mcp - 결과 없음

```
입력: "주식 정보 알려줘"

출력:
🔍 "주식 정보 알려줘" 검색 결과

❌ 적합한 MCP를 찾지 못했습니다.

💬 현재 PlayMCP에 주식/증권 관련 MCP가 등록되어 있지 않습니다.
```

## 기술 스택

- TypeScript / Node.js
- MCP SDK (@modelcontextprotocol/sdk)
- Google Gemini 2.0 Flash Lite (LLM 기반 매칭)

## 비용

- **Railway**: $5/월 (Hobby Plan)
- **Gemini 2.0 Flash Lite**: 무료 (일일 1,500 요청)

## Rate Limit

Gemini 무료 티어 제한:
- 분당 15 요청
- 일일 1,500 요청

## 라이선스

MIT