개인 비서 MCP 서버

Google 캘린더, Obsidian Vault, Trello, 웹 페이지 분석 기능 등 다양한 서비스와 통합되는 강력한 개인 비서 서버입니다. FastMCP를 기반으로 구축된 이 서버는 디지털 라이프를 관리하기 위한 통합 인터페이스를 제공합니다.

특징

Google 캘린더 통합
- 캘린더 이벤트를 만들고, 읽고, 업데이트하고, 삭제합니다.
- 예정된 이벤트 목록
흑요석 금고 관리
- 메모 생성, 읽기, 업데이트 및 삭제
- 노트에서 전체 텍스트 검색
- 폴더 관리(생성, 삭제, 검색, 목록)
Trello 통합
- 보드, 리스트, 카드 관리
- 카드 생성, 업데이트 및 삭제
- 텍스트 쿼리로 카드 검색
웹 페이지 파싱
- 모든 URL에서 HTML 콘텐츠 추출 및 정리

필수 조건

Python 3.10 이상
Poetry(Python 패키지 관리자)
Google 캘린더 API 자격 증명
Trello API 자격 증명(Trello 기능 사용 시)
흑요석 보관소(흑요석 기능 사용 시)

설치

저장소를 복제합니다.지엑스피1
Poetry를 사용하여 종속성을 설치합니다.
poetry install
Google 캘린더 API 설정:
- Google Cloud Console 로 이동
- 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요
- Google 캘린더 API 활성화
- OAuth 2.0 자격 증명 만들기
- 자격 증명을 다운로드하고 프로젝트 루트에 credentials.json 으로 저장합니다.
Trello API 설정(선택 사항):
- Trello 개발자 포털 로 이동
- API 키와 토큰을 받으세요
- 환경 변수나 구성 파일에 추가하세요

구성

Google 캘린더에 인증하려면 초기 설정을 실행하세요.
poetry run python main.py
- 이렇게 하면 Google 인증을 위한 브라우저 창이 열립니다.
- 프롬프트에 따라 애플리케이션을 승인하세요.

용법

서버를 시작합니다:
poetry run python main.py
서버가 시작되고 MCP 호환 클라이언트 연결을 수락할 준비가 됩니다.
MCP 호환 클라이언트를 사용하여 서버와 상호 작용하세요. 서버는 다음과 같은 도구를 제공합니다.
- 캘린더 관리
- 흑요석 금고 작업
- Trello 보드 관리
- 웹 페이지 파싱

Anthropic Claude 데스크톱 구성

Anthropic Claude Desktop과 함께 이 서버를 사용하려면 Claude Desktop 설정에 다음 구성을 추가하세요.

{
   "mcpServers": {
      "personal-assistant": {
         "command": "/path/to/your/venv/bin/python",
         "args": ["/path/to/your/project/main.py"],
         "env": {
                 "GOOGLE_CREDENTIALS_PATH": "/path/to/your/credentials.json",
                 "GOOGLE_TOKEN_PATH": "/path/to/your/token.json",
                 "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault",
                 "OBSIDIAN_DEFAULT_FOLDER": "your_default_folder",
                 "LOG_PATH": "/path/to/log.txt",
                 "TRELLO_TOKEN": "your_trello_token",
                 "TRELLO_API_KEY": "your_trello_api_key"
         }
      }
   }
}

경로와 자격 증명을 실제 값으로 바꾸세요.

command : Python 가상 환경의 Python 실행 파일 경로
args : 프로젝트의 main.py 파일에 대한 경로
GOOGLE_CREDENTIALS_PATH : Google 캘린더 자격 증명 파일의 경로
GOOGLE_TOKEN_PATH : Google 캘린더 토큰 파일 경로
OBSIDIAN_VAULT_PATH : Obsidian 볼트 경로
OBSIDIAN_DEFAULT_FOLDER : 새 노트가 생성될 볼트의 기본 폴더 경로
TRELLO_TOKEN : Trello API 토큰
TRELLO_API_KEY : Trello API 키

개발

이 프로젝트는 종속성 관리를 위해 Poetry를 사용합니다.
모든 도구는 main.py 에 등록되어 있습니다.
서비스별 구현은 services/ 디렉토리에 있습니다.
Python 코드에 대한 PEP 8 스타일 가이드라인을 따르세요

기여하다

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
브랜치에 푸시( git push origin feature/amazing-feature )
풀 리퀘스트 열기

가입하다:

텔레그램 블로그

Personal Assistant MCP Server

Integrations

개인 비서 MCP 서버

특징

필수 조건

설치

구성

용법

Anthropic Claude 데스크톱 구성

개발

기여하다