Personal Ops Assistant (MCP)

一个基于 Model Context Protocol (MCP)、FastMCP、Google Gemini 和 FastAPI 构建的 AI 驱动的个人运维助手。

它能在运行时动态发现并执行运维工具，通过 Web 界面搜索本地笔记、查看 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 提取并总结内容。

• Web 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