Personal Ops Assistant (MCP)

Model Context Protocol (MCP), FastMCP, Google Gemini, FastAPI를 기반으로 구축된 AI 기반 개인 운영 어시스턴트입니다.

로컬 노트 검색, GitHub 저장소 활동 확인, 웹 인터페이스를 통한 실시간 웹 페이지 요약을 위해 런타임에 운영 도구를 동적으로 발견하고 실행합니다.

🚀 주요 기능

• Model Context Protocol (MCP): stdio를 통해 Gemini 클라이언트 에이전트를 로컬 FastMCP 도구 서버에 연결합니다.

• 동적 도구 발견: MCP 도구가 나열되고 Gemini 함수 선언으로 변환된 후 런타임에 동적으로 호출됩니다.

• 통합 도구:

  • search_local_notes: 로컬 .md 및 .txt 파일에서 키워드를 검색하고 파일 내용을 반환합니다.

  • github_recent_activity: GitHub REST API를 사용하여 모든 GitHub 저장소의 최근 커밋 로그를 가져옵니다.

  • summarize_webpage: 실시간 URL에서 콘텐츠를 추출하고 요약합니다.

• 웹 UI: 실시간 MCP 도구 호출 검사 로그가 포함된 현대적인 채팅 인터페이스.

Related MCP server: MCP Docs Server

📁 프로젝트 구조

├── notes/              # Local markdown and text notes directory
├── static/
│   └── index.html      # Responsive chat interface
├── agent.py            # Gemini client & MCP dynamic tool orchestration loop
├── server.py           # FastMCP server exposing local tools over stdio
├── app.py              # FastAPI server & API endpoints
├── requirements.txt    # Project dependencies
└── README.md           # Project documentation