MCP, Gemini 및 Playwright를 사용한 AI 날씨 에이전트

개요

이 프로젝트는 Model Context Protocol(MCP), Google Gemini 및 Playwright를 사용하여 이스라엘 도시의 현재 날씨 정보를 검색하는 AI 에이전트를 구현합니다.

사용자가 도시의 날씨를 물어보면 에이전트는 날씨 웹사이트를 열고, 요청된 도시를 검색하고, 페이지에서 날씨 정보를 추출한 후 웹사이트 내용을 기반으로 답변을 반환합니다.

이 프로젝트는 또한 최종 응답을 생성하기 전에 웹 페이지에서 날씨 정보를 추출하여 언어 모델에 추가 컨텍스트로 제공하는 간단한 검색 단계를 포함합니다.

기술 스택

• Python

• Google Gemini API

• MCP (Model Context Protocol)

• Playwright

• AsyncIO

• python-dotenv

프로젝트 구조

host.py                 # Main chat application
client.py               # MCP client
weather_Israel.py       # MCP weather server
README.md
requirements.txt

작동 방식

1. 사용자가 이스라엘 도시의 날씨를 물어봅니다.

2. Gemini가 적절한 MCP 도구를 선택합니다.

3. Playwright가 날씨 웹사이트를 엽니다.

4. 요청된 도시가 검색 상자에 입력됩니다.

5. 자동 완성 목록에서 도시가 선택됩니다.

6. 날씨 페이지가 로드됩니다.

7. 페이지에서 날씨 정보가 추출됩니다.

8. 추출된 텍스트가 Gemini에 반환됩니다.

9. Gemini가 추출된 정보를 사용하여 최종 답변을 생성합니다.

기능

• 이스라엘 도시에 대한 날씨 쿼리를 지원합니다.

• 히브리어 또는 영어로 된 도시 이름을 허용합니다.

• Playwright를 사용하여 실시간 날씨 웹사이트를 탐색합니다.

• 웹사이트에서 직접 날씨 정보를 추출합니다.

• 답변하기 전에 추출된 콘텐츠를 언어 모델에 제공합니다.

• 모델의 내부 지식에 의존하는 대신 웹사이트 콘텐츠를 사용합니다.

설치

저장소를 클론합니다:

git clone https://github.com/YisNiz/AI-MCP-with-RAG-project

필요한 패키지를 설치합니다:

pip install -r requirements.txt

다음 내용이 포함된 .env 파일을 생성합니다:

GEMINI_API_KEY=YOUR_API_KEY

Playwright 브라우저를 설치합니다:

playwright install

프로젝트를 실행합니다:

python host.py

예시 질문

• 예루살렘의 날씨는 어떤가요?

• 텔아비브의 날씨

• מזג האוויר בחיפה

• מה מזג האוויר בבאר שבע?

참고 사항

• 날씨 정보는 실시간 날씨 웹사이트에서 검색됩니다.

• 언어 모델은 추출된 웹사이트 콘텐츠를 사용하여 답변하도록 지시됩니다.

• 이 프로젝트는 LLM과 MCP 도구 및 브라우저 자동화의 통합을 보여줍니다.

작성자

Yisca Nazri