Personal Ops Assistant (MCP)

Ein KI-gestützter persönlicher Operations-Assistent, der mit dem Model Context Protocol (MCP), FastMCP, Google Gemini und FastAPI erstellt wurde.

Er erkennt und führt betriebliche Tools zur Laufzeit dynamisch aus, um lokale Notizen zu durchsuchen, GitHub-Repository-Aktivitäten zu prüfen und Live-Webseiten über eine Webschnittstelle zusammenzufassen.

🚀 Hauptfunktionen

• Model Context Protocol (MCP): Verbindet einen Gemini-Client-Agenten über stdio mit einem lokalen FastMCP-Tool-Server.

• Dynamische Tool-Erkennung: MCP-Tools werden aufgelistet, in Gemini-Funktionsdeklarationen umgewandelt und zur Laufzeit dynamisch aufgerufen.

• Integrierte Tools:

  • search_local_notes: Durchsucht lokale .md- und .txt-Dateien nach Schlüsselwörtern und gibt den Dateiinhalt zurück.

  • github_recent_activity: Ruft aktuelle Commit-Protokolle aus beliebigen GitHub-Repositories über die GitHub-REST-API ab.

  • summarize_webpage: Extrahiert und fasst Inhalte von Live-URLs zusammen.

• Web-UI: Moderne Chat-Oberfläche mit Live-Inspektionsprotokollen für MCP-Tool-Aufrufe.

Related MCP server: MCP Docs Server

📁 Projektstruktur

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