README.md•2 kB
# ADK 기반 MCP 클라이언트
이 디렉토리에는 Google Agent Development Kit (ADK)를 사용하여 구축된 고급 MCP 클라이언트가 포함되어 있습니다.
## 목적
이 클라이언트는 단순한 테스트를 넘어, 자체적으로 AI 에이전트의 능력을 갖춘 '스마트 클라이언트' 역할을 합니다. 사용자의 입력을 받아 내부의 AI 에이전트가 판단하고, `app_mcp_server`와 상호작용하여 보다 복잡한 작업을 수행할 수 있습니다.
## 주요 기능
- **ADK 기반 에이전트 내장**: 클라이언트 자체가 AI 에이전트로서, 자체적인 AI Provider 설정을 통해 추론 및 도구 사용 능력을 갖습니다.
- **서버 통신**: `mcp_server_config.json` 파일에 정의된 주소를 통해 `app_mcp_server`에 연결하고 필요한 정보를 요청하거나 작업을 지시합니다.
- **콘솔 인터페이스**: `cmd.py`를 통해 사용자가 직접 명령을 내릴 수 있는 대화형 명령줄 인터페이스(CLI)를 제공합니다.
## 주요 파일
- `client.py`: MCP 서버와의 통신을 담당하는 클라이언트 로직입니다.
- `cmd.py`: 사용자와 상호작용하는 명령줄 인터페이스를 구현합니다.
- `agent.py`: 클라이언트에 내장된 ADK 에이전트의 로직을 정의합니다.
- `ai_config.py` & `ai_providers.py`: 클라이언트 측 에이전트가 사용할 AI Provider(LLM)를 설정하고 관리합니다.
- `mcp_server_config.json`: 접속할 MCP 서버의 주소와 포트 정보를 담고 있습니다.
- `env.example`: 클라이언트 측 AI Provider를 위한 API 키 등 필요한 환경 변수 예시입니다.
## 실행 방법
이 클라이언트를 실행하기 위한 별도의 배치 스크립트는 `run_cmd`에 아직 없습니다. `cmd.py`가 실행 진입점이므로, 다음과 같은 명령어로 실행할 수 있습니다.
```bash
# 프로젝트 루트에서 가상환경 활성화 후
python -m mcp_client_adk.cmd
```