MCP 개인 비서 에이전트

모델 컨텍스트 프로토콜(MCP)을 사용하여 구축된 다재다능한 개인 비서 AI 에이전트로, 일정, 작업, 이메일 등을 처리하는 데 도움을 줍니다.

개요

이 프로젝트는 개인 비서 에이전트를 위한 도구 세트를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. Claude for Desktop과 같은 MCP 클라이언트와 통합하여 AI 비서에게 다음과 같은 기능을 제공할 수 있습니다.

• 캘린더 이벤트 관리

• 작업 및 할 일 추적

• 이메일 읽기 및 보내기

• 웹을 검색하고 정보를 검색하세요

• 스마트 홈 기기를 제어하세요

Related MCP server: Meeting BaaS MCP Server

요구 사항

⚠️ 중요: MCP SDK를 사용하려면 Python 3.10 이상이 필요합니다. 이전 Python 버전에서는 서버가 작동하지 않습니다.

• 파이썬 3.10+

• MCP SDK 1.2.0+

• 필수 Python 패키지(requirements.txt 참조)

설치

1. 저장소를 복제합니다.

지엑스피1

2. Python 3.10 이상이 있는지 확인하세요.

python --version

3. 시스템의 Python이 3.10보다 이전 버전인 경우 호환되는 환경을 설정하세요.

# Using conda
conda create -n mcp-env python=3.10
conda activate mcp-env

# OR using venv (if Python 3.10+ is installed elsewhere)
python3.10 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

4. 종속성 설치:

pip install -r requirements.txt

5. 예제 파일을 복사하여 환경 변수를 구성합니다.

cp .env.example .env

6. API 자격 증명과 설정으로 .env 파일을 편집합니다.

서버 실행

다음을 사용하여 MCP 서버를 시작합니다.

python mcp_server.py

서버가 시작되어 MCP 클라이언트 연결을 수신합니다.

데스크톱용 Claude에 연결

1. 데스크톱용 Claude 설치

2. 다음 구성 파일을 편집하여 Claude for Desktop이 이 MCP 서버를 사용하도록 구성하세요.

   • MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. 다음 구성을 추가합니다.

{
  "mcpServers": {
    "personal-assistant": {
      "command": "/path/to/python",
      "args": [
        "/absolute/path/to/mcp-pa-ai-agent/mcp_server.py"
      ]
    }
  }
}

가상 환경을 사용하는 경우 해당 환경의 Python 실행 파일을 가리키도록 하세요.

4. 데스크톱용 Claude 재시작

사용 가능한 도구

달력

• get_events : 예정된 캘린더 이벤트를 검색합니다.

• create_event : 새로운 캘린더 이벤트를 예약합니다

작업

• list_tasks : 모든 작업 보기 또는 상태별 필터링

• add_task : 새로운 작업을 생성합니다

• update_task_status : 작업을 보류, 진행 중 또는 완료로 표시합니다.

이메일

• get_emails : 받은 편지함의 최근 이메일 목록

• read_email : 특정 이메일의 전체 내용을 봅니다.

• send_email : 새 이메일을 작성하고 보냅니다.

지식

• web_search : 웹에서 정보를 검색합니다

• get_weather : 현재 날씨 정보를 가져옵니다

• get_news : 최신 뉴스 기사 검색

스마트 홈

• list_devices : 모든 스마트 홈 기기 보기

• control_device : 스마트 홈 기기(조명, 온도 조절기 등)를 제어합니다.

• get_device_state : 장치의 현재 상태에 대한 자세한 정보를 가져옵니다.

구성

서버는 다양한 서비스에 액세스하기 위해 다양한 API 키와 자격 증명이 필요합니다.

• Google API : 캘린더 및 이메일 기능(OAuth2 자격 증명)

• 날씨 API : 날씨 정보

• 뉴스 API : 뉴스 검색용

• 홈 어시스턴트 : 스마트 홈 제어

구성 가능한 모든 옵션은 .env.example 파일을 참조하세요.

문제 해결

Python 버전 문제

다음과 같은 오류가 표시되는 경우

Error: Python 3.10 or higher is required for the MCP server.

Python 버전을 업그레이드하거나 Python 3.10 이상이 포함된 가상 환경을 사용해야 합니다.

MCP SDK 설치 문제

MCP SDK 설치 중 문제가 발생하는 경우:

ERROR: Could not find a version that satisfies the requirement mcp>=1.2.0

Python 3.10 이상을 사용하고 pip가 업데이트되었는지 확인하세요.

pip install --upgrade pip

개발

서버에 새로운 기능을 추가하려면 다음을 수행하세요.

1. modules/ 디렉토리에 새 모듈을 만듭니다.

2. @mcp.tool() 데코레이터를 사용하여 함수 구현

3. mcp_server.py 에 모듈을 가져옵니다.

특허

MIT

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.