内容
# 파이썬으로 MCP Agent 만들기
YouTube 검색, 요약, 채널 분석 기능을 갖춘 유튜브 에이전트를 MCP로 구현한 예제입니다.
## MCP (Model Context Protocol) 소개
- AI가 외부 데이터의 도구(Tools)에 효과적으로 연결할 수 있는 표준화된 방식
- 특히 다양한 도구의 표준화된 연결로 많이 활용되고 있음
- **MCP Server**: 사용할 수 있는 도구(tool)를 정의하고 제공하는 역할
- **MCP Client**: 정의된 도구를 불러와 사용 (Claude Desktop, Cursor, OpenAI Agents SDK)
- 이번 예제에서는 유튜브 컨텐츠 분석을 위한 MCP Server를 만들어보고, OpenAI Agents SDK 기반의 MCP Client와도 연결해볼 예정입니다.
## 초기 셋팅
1. 레포지토리 clone 또는 다운로드하기
```bash
git clone https://github.com/dabidstudio/python-mcp-agent.git
cd python-mcp-agent
```
2. [OpenAI 키 발급](https://github.com/dabidstudio/dabidstudio_guides/blob/main/get-openai-api-key.md)
3. [YouTube Data API Key 발급](https://github.com/dabidstudio/dabidstudio_guides/blob/main/get-youtube-data-api.md)
4. .env.example를 복사한 후 API 키를 입력하고 .env로 저장
```bash
OPENAI_API_KEY=api키_입력
YOUTUBE_API_KEY=api_키_입력
```
5. [파이썬 가상환경 설정](https://github.com/dabidstudio/dabidstudio_guides/blob/main/python-set-venv.md)
```bash
python -m venv venv
venv\Scripts\activate # Mac은 source venv/bin/activate
```
6. 패키지 설치
```bash
pip install mcp openai-agents streamlit youtube-transcript-api python-dotenv requests
```
## MCP 클라이언트 연동을 위한 준비
Claude, Cursor와 같은 MCP 클라이언트 애플리케이션에서 로컬 MCP 서버를 연동하려면,
서버 실행에 필요한 **Python 실행 파일 경로**와 **MCP 서버 스크립트 경로**를 JSON 설정에 입력해야 합니다.
- 내 경로에 알맞게 mcp.json을 수정해둡니다.
### 경로 구성 예시
#### ✅ Windows 예시
(예: 프로젝트 폴더가 `C:\projects\dabidstudio_videos\python_mcp_agent`인 경우)
> **주의:** Windows에서는 JSON 문법상 `\` 대신 `\\` (역슬래시 두 번)을 사용해야 합니다.
```json
{
"mcpServers": {
"mcp-test": {
"command": "C:\\projects\\dabidstudio_videos\\python_mcp_agent\\venv\\Scripts\\python.exe",
"args": [
"C:\\projects\\dabidstudio_videos\\python_mcp_agent\\2_mcp_server.py"
]
}
}
}
```
---
#### ✅ macOS / Linux 예시
(예: 프로젝트 폴더가 `/Users/yourname/projects/python_mcp_agent`인 경우)
```json
{
"mcpServers": {
"mcp-test": {
"command": "/Users/yourname/projects/python_mcp_agent/venv/bin/python",
"args": [
"/Users/yourname/projects/python_mcp_agent/2_mcp_server.py"
]
}
}
}
```
---
## 폴더 구조
```
python-mcp-agent/
├── 1_mcp_server_functions.ipynb # MCP 서버 함수 예제 노트북
├── 2_mcp_server.py # MCP 서버 구현 예제
├── 3_openai_agents_basics.py # OpenAI Agent 기본 예제
├── 4_mcp_client.py # Streamlit MCP Client 예제
├── .env.example # 환경변수 예제 파일
└── mcp.json # MCP 서버 설정 파일
```
MCP 市场