# Gemini + MCP 데모 스크립트 v1: 동기 및 배경

## 왜 이 프로젝트를 시작했는가?

### Claude Agent SDK의 놀라운 발견

최근 Claude Agent SDK를 사용하면서 흥미로운 점을 발견했다. **Langchain 같은 무거운 프레임워크 없이도** 다음과 같은 작업들이 가능했다:

- 웹 검색
- 파일 읽기/쓰기
- Claude Skills 활용
- 다양한 도구(tools) 통합

전통적으로 LLM에 외부 도구를 연결하려면 Langchain이나 LlamaIndex 같은 프레임워크를 사용해야 했다. 하지만 Claude Agent SDK는 자체적으로 이런 기능들을 깔끔하게 제공했다.

### 핵심 질문의 등장

Claude Agent SDK를 사용하면서 자연스럽게 이런 질문이 떠올랐다:

**"Gemini SDK도 비슷한 기능이 있지 않을까?"**

Google의 Gemini는 강력한 LLM이고, 공식 TypeScript SDK도 제공한다. 혹시 Gemini SDK도 Claude처럼:
- 외부 도구를 쉽게 연결할 수 있지 않을까?
- 특별한 프레임워크 없이도 확장 가능하지 않을까?

더 나아가:

**"적어도 MCP(Model Context Protocol) server는 사용할 수 있지 않을까?"**

### MCP란?

MCP(Model Context Protocol)는 Anthropic이 주도하는 오픈 프로토콜이다. LLM과 외부 도구/데이터 소스를 표준화된 방식으로 연결하는 것이 목표다.

MCP의 장점:
- 표준화된 인터페이스
- 재사용 가능한 서버들
- 다양한 transport 방식 (stdio, HTTP 등)
- 언어/플랫폼 독립적

이미 많은 MCP server들이 공개되어 있다:
- Filesystem MCP server
- Database MCP server
- Web search MCP server
- **Vercel MCP server** (Vercel API 접근)

### 프로젝트의 목표

이 프로젝트는 다음을 탐구한다:

1. **Gemini SDK의 가능성**
   - Gemini SDK로 MCP server를 호출할 수 있는가?
   - 어떤 방식으로 통합 가능한가?

2. **실용성 검증**
   - 실제로 동작하는 데모를 만들 수 있는가?
   - Claude Agent SDK와 비교했을 때 어떤가?

3. **개발자 경험**
   - 구현 난이도는?
   - 실무에서 사용할 만한가?

### 왜 Vercel MCP Server인가?

이 프로젝트에서는 **Vercel MCP server**를 사용하기로 했다:

- HTTP transport 지원 (브라우저/서버 양쪽에서 사용 가능)
- 공개적으로 접근 가능
- 실용적인 use case (배포 상태 확인, 로그 조회 등)
- MCP server를 직접 구축하는 오버헤드 없음

### 다음 단계

v2에서는 MCP의 기본 개념과 동작 원리를 좀 더 자세히 살펴볼 것이다.

---

**작성일**: 2025-11-26
**대상**: 백엔드/프론트엔드 엔지니어
**난이도**: 중급