모델 컨텍스트 프로토콜(MCP)
모든 출처는 https://github.com/ShawhinT/YouTube-Blog/ 입니다.
AI 에이전트 시리즈의 네 번째 예시입니다. 여기에서는 모든 AI 앱이 인공 가상 비서(AVA) 도구 세트에 접근할 수 있도록 고객 MCP 서버를 구축합니다.
모래밭
이 예제를 실행하는 방법
- 이 저장소를 복제하세요
- 아직 uv를 설치하지 않았다면 설치하세요
지엑스피1
- 개발 모드에서 서버 테스트
uv run mcp dev mcp-server-example.py
- AI 앱에 서버 구성을 추가합니다(예: Claude Desktop 또는 Cursor).
{
"mcpServers": {
"AVA": {
"command": "/Users/shawhin/.local/bin/uv", # replace with global path to your uv installation
"args": [
"--directory",
"/Users/shawhin/Documents/_code/_stv/sandbox/ava-mcp/", # replace with global path to repo
"run",
"mcp-server-example.py"
]
}
}
}
AVA 동작 사용자 지정
개인 정보 및 기본 설정 업데이트
- 프로젝트 디렉토리에서
prompts/ava.md 파일을 찾으세요. - 다음을 사용하여 파일을 사용자 정의하세요.
- 커뮤니케이션 선호도
- 작업 처리를 위한 구체적인 지침
- AVA에 대한 기타 관련 지침
환경 설정(.env)
- 프로젝트의 루트 디렉토리에 다음 변수를 사용하여
.env 파일을 만듭니다.
USER_EMAIL=your_email_address
# Google OAuth Credentials
GOOGLE_CREDENTIALS_PATH=.config/ava-agent/credentials.json
GOOGLE_TOKEN_PATH=.config/ava-agent/token.json
필수 환경 변수:
USER_EMAIL : 이 애플리케이션에 사용할 Gmail 주소GOOGLE_CREDENTIALS_PATH : Google OAuth 자격 증명 파일의 경로GOOGLE_TOKEN_PATH : Google OAuth 토큰이 저장될 경로
Google OAuth 설정
1. 프로젝트 디렉토리 구조 생성
먼저, 필요한 디렉토리 구조를 만듭니다.
mkdir -p .config/ava-agent
2. Google Cloud 프로젝트 설정
- Google Cloud Console 로 이동
- 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요
- Gmail API 활성화:
- 탐색 메뉴에서 "API 및 서비스" > "라이브러리"로 이동하세요.
- "Gmail API"를 검색하세요
- "활성화"를 클릭하세요
3. OAuth 자격 증명 생성
- Google Cloud Console에서:
- "API 및 서비스" > "자격 증명"으로 이동하세요.
- "자격 증명 만들기" > "OAuth 클라이언트 ID"를 클릭하세요.
- 애플리케이션 유형으로 "데스크톱 애플리케이션"을 선택하세요
- 이름을 지정합니다(예: "AVA Gmail 클라이언트")
- "만들기"를 클릭하세요
- 자격 증명을 다운로드하세요:
- 생성 후 "JSON 다운로드"를 클릭하세요.
- 다운로드한 파일을
.config/ava-agent/ 에 credentials.json 으로 저장합니다. - 파일에는 클라이언트 ID와 클라이언트 비밀번호가 포함되어야 합니다.
4. OAuth 동의 화면 구성
- Google Cloud Console에서:
- "API 및 서비스" > "OAuth 동의 화면"으로 이동하세요.
- "외부" 사용자 유형을 선택하세요
- 필수 정보를 입력하세요:
- Gmail API 범위 추가:
https://www.googleapis.com/auth/gmail.modify - 테스트 사용자로 이메일을 추가하세요
- 구성을 완료하세요
Google에 로그인
서버가 Gmail 계정에 접근하려면 먼저 권한을 부여해야 합니다. uv run oauth.py 실행하면 다음과 같은 작업이 수행됩니다.
token.json 이 있는지 확인하세요- 찾을 수 없는 경우 Google OAuth 인증 흐름이 시작됩니다.
- 브라우저에서 인증 과정을 안내합니다.
- Google 계정에 로그인하라는 메시지가 표시됩니다.
- 요청된 권한을 부여합니다
- 애플리케이션은 자동으로 토큰을 저장합니다.
- 토큰을 자동으로 생성하고 저장합니다.
보안 참고 사항
파일 보호
.env 파일이나 token.json 버전 제어에 커밋하지 마십시오.- Google 자격 증명을 안전하게 유지하세요
.gitignore 에 다음을 추가하세요..env
.config/ava-agent/token.json
.config/ava-agent/credentials.json