Personal Ops Assistant (MCP)

Персональный операционный ассистент на базе ИИ, созданный с использованием Model Context Protocol (MCP), FastMCP, Google Gemini и FastAPI.

Он динамически обнаруживает и выполняет операционные инструменты во время выполнения для поиска по локальным заметкам, проверки активности репозиториев GitHub и обобщения содержимого живых веб-страниц через веб-интерфейс.

🚀 Ключевые возможности

• Model Context Protocol (MCP): Подключает клиентский агент Gemini к локальному серверу инструментов FastMCP через stdio.

• Динамическое обнаружение инструментов: Инструменты MCP перечисляются, преобразуются в объявления функций Gemini и вызываются динамически во время выполнения.

• Встроенные инструменты:

  • search_local_notes: Ищет ключевые слова в локальных файлах .md и .txt и возвращает содержимое файлов.

  • github_recent_activity: Получает последние журналы коммитов из любого репозитория GitHub с помощью GitHub REST API.

  • summarize_webpage: Извлекает и обобщает содержимое живых URL-адресов.

• Веб-интерфейс: Современный чат-интерфейс с журналами проверки вызовов инструментов 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