Personal Ops Assistant (MCP)

Un asistente personal de operaciones impulsado por IA, construido con el Model Context Protocol (MCP), FastMCP, Google Gemini y FastAPI.

Descubre y ejecuta dinámicamente herramientas operativas en tiempo de ejecución para buscar notas locales, inspeccionar la actividad de repositorios de GitHub y resumir páginas web en vivo a través de una interfaz web.

🚀 Características principales

• Model Context Protocol (MCP): Conecta un agente cliente de Gemini a un servidor de herramientas FastMCP local mediante stdio.

• Descubrimiento dinámico de herramientas: Las herramientas MCP se enumeran, se convierten en declaraciones de funciones de Gemini y se invocan dinámicamente en tiempo de ejecución.

• Herramientas integradas:

  • search_local_notes: Busca palabras clave en archivos locales .md y .txt y devuelve el contenido de los archivos.

  • github_recent_activity: Obtiene los registros de commits recientes de cualquier repositorio de GitHub mediante la API REST de GitHub.

  • summarize_webpage: Extrae y resume el contenido de URLs en vivo.

• Interfaz web: Interfaz de chat moderna con registros de inspección de llamadas a herramientas MCP en vivo.

Related MCP server: MCP Docs Server

📁 Estructura del proyecto

├── 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