Personal Ops Assistant (MCP)

Model Context Protocol (MCP)、FastMCP、Google Gemini、FastAPI を使用して構築された、AI を活用したパーソナル運用アシスタントです。

実行時に運用ツールを動的に検出して実行し、ローカルノートの検索、GitHub リポジトリのアクティビティの確認、ライブ Web ページの要約を Web インターフェースを通じて行います。

🚀 主な機能

• 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