AVA MCP Server

모델 컨텍스트 프로토콜(MCP)

모든 출처는 https://github.com/ShawhinT/YouTube-Blog/ 입니다.

AI 에이전트 시리즈의 네 번째 예시입니다. 여기에서는 모든 AI 앱이 인공 가상 비서(AVA) 도구 세트에 접근할 수 있도록 고객 MCP 서버를 구축합니다.

모래밭

• 동영상
• 블로그

이 예제를 실행하는 방법

1. 이 저장소를 복제하세요
2. 아직 uv를 설치하지 않았다면 설치하세요

지엑스피1

3. 개발 모드에서 서버 테스트

4. AI 앱에 서버 구성을 추가합니다(예: Claude Desktop 또는 Cursor).

AVA 동작 사용자 지정

개인 정보 및 기본 설정 업데이트

1. 프로젝트 디렉토리에서 prompts/ava.md 파일을 찾으세요.
2. 다음을 사용하여 파일을 사용자 정의하세요.
   • 커뮤니케이션 선호도
   • 작업 처리를 위한 구체적인 지침
   • AVA에 대한 기타 관련 지침

환경 설정(.env)

1. 프로젝트의 루트 디렉토리에 다음 변수를 사용하여 .env 파일을 만듭니다.

필수 환경 변수:

• USER_EMAIL : 이 애플리케이션에 사용할 Gmail 주소
• GOOGLE_CREDENTIALS_PATH : Google OAuth 자격 증명 파일의 경로
• GOOGLE_TOKEN_PATH : Google OAuth 토큰이 저장될 경로

Google OAuth 설정

1. 프로젝트 디렉토리 구조 생성

먼저, 필요한 디렉토리 구조를 만듭니다.

2. Google Cloud 프로젝트 설정

1. Google Cloud Console 로 이동
2. 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요
3. Gmail API 활성화:
   • 탐색 메뉴에서 "API 및 서비스" > "라이브러리"로 이동하세요.
   • "Gmail API"를 검색하세요
   • "활성화"를 클릭하세요

3. OAuth 자격 증명 생성

1. Google Cloud Console에서:
   • "API 및 서비스" > "자격 증명"으로 이동하세요.
   • "자격 증명 만들기" > "OAuth 클라이언트 ID"를 클릭하세요.
   • 애플리케이션 유형으로 "데스크톱 애플리케이션"을 선택하세요
   • 이름을 지정합니다(예: "AVA Gmail 클라이언트")
   • "만들기"를 클릭하세요
2. 자격 증명을 다운로드하세요:
   • 생성 후 "JSON 다운로드"를 클릭하세요.
   • 다운로드한 파일을 .config/ava-agent/ 에 credentials.json 으로 저장합니다.
   • 파일에는 클라이언트 ID와 클라이언트 비밀번호가 포함되어야 합니다.

4. OAuth 동의 화면 구성

1. Google Cloud Console에서:
   • "API 및 서비스" > "OAuth 동의 화면"으로 이동하세요.
   • "외부" 사용자 유형을 선택하세요
   • 필수 정보를 입력하세요:
     • 앱 이름
     • 사용자 지원 이메일
     • 개발자 연락처 정보
   • Gmail API 범위 추가: https://www.googleapis.com/auth/gmail.modify
   • 테스트 사용자로 이메일을 추가하세요
   • 구성을 완료하세요

Google에 로그인

서버가 Gmail 계정에 접근하려면 먼저 권한을 부여해야 합니다. uv run oauth.py 실행하면 다음과 같은 작업이 수행됩니다.

1. token.json 이 있는지 확인하세요
2. 찾을 수 없는 경우 Google OAuth 인증 흐름이 시작됩니다.
3. 브라우저에서 인증 과정을 안내합니다.
   • Google 계정에 로그인하라는 메시지가 표시됩니다.
   • 요청된 권한을 부여합니다
   • 애플리케이션은 자동으로 토큰을 저장합니다.
4. 토큰을 자동으로 생성하고 저장합니다.

보안 참고 사항

파일 보호

• .env 파일이나 token.json 버전 제어에 커밋하지 마십시오.
• Google 자격 증명을 안전하게 유지하세요
• .gitignore 에 다음을 추가하세요.
  .env .config/ava-agent/token.json .config/ava-agent/credentials.json