local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides integration with Google API for calendar management and email functionality, allowing access to events, creating new events, reading and sending emails.
Enables smart home control through Home Assistant, providing capabilities to list devices, control them, and get detailed information about device states.

MCP 개인 비서 에이전트

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

개요

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

캘린더 이벤트 관리
작업 및 할 일 추적
이메일 읽기 및 보내기
웹을 검색하고 정보를 검색하세요
스마트 홈 기기를 제어하세요

요구 사항

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

파이썬 3.10+
MCP SDK 1.2.0+
필수 Python 패키지(requirements.txt 참조)

설치

저장소를 복제합니다.

지엑스피1

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

python --version

시스템의 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

종속성 설치:

pip install -r requirements.txt

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

cp .env.example .env

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

서버 실행

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

python mcp_server.py

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

데스크톱용 Claude에 연결

데스크톱용 Claude 설치
다음 구성 파일을 편집하여 Claude for Desktop이 이 MCP 서버를 사용하도록 구성하세요.
- MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
다음 구성을 추가합니다.

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

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

데스크톱용 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

개발

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

modules/ 디렉토리에 새 모듈을 만듭니다.
@mcp.tool() 데코레이터를 사용하여 함수 구현
mcp_server.py 에 모듈을 가져옵니다.

특허

MIT

기여하다

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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

AI 어시스턴트가 일정을 관리하고, 작업을 추적하고, 이메일을 처리하고, 웹을 검색하고, 스마트 홈 기기를 제어할 수 있도록 하는 다재다능한 모델 컨텍스트 프로토콜 서버입니다.

Related Resources

Reddit Discussion about this server

MCP Personal Assistant Agent