Pontonkid commited on
Commit
f455833
·
verified ·
1 Parent(s): 00f8bc5

Update README.md

Browse files

# AgentOpsMCP 🛠

**Autonomous AI agent platform for analyzing logs, applying fixes, and generating actionable reports.**

**Tags:** `mcp-in-action-track-enterprise` `mcp-in-action-track-consumer` `mcp-in-action-track-creative` `mcp` `gradio` `gemini` `llamaindex` `ai` `automation` `log-analysis`

---

## Overview

**AgentOpsMCP** is an MCP-enabled Gradio app that allows users to **upload logs, analyze errors and warnings, and generate step-by-step actionable reports**.

This tool demonstrates **autonomous agent behavior** — planning, reasoning, and execution — while using **MCP servers as tools**. It is built for **MCP’s 1st Birthday Hackathon — Track 2: MCP in Action**.

---

## Features

* **MCP-Compliant Servers**:

* **File Server**: Upload, list, and read files.
* **Executor Server**: Apply automated fixes or patches.
* **Memory Server**: Store agent memory and persistent state.

* **Multi-Modal Analysis**:

* Accepts **text log files**.
* Uses **Gemini API** for intelligent analysis and reasoning.
* Optional **LlamaIndex integration** for summarizing large logs.

* **Agent Actions & Planning**:

* Detects errors, warnings, and critical messages.
* Generates suggested fixes automatically.
* Produces **PDF incident reports** with summary, issues, and recommendations.

* **Interactive Gradio UI**:

* Upload logs and select files from MCP server.
* View **agent summary, detected issues, and suggested actions**.
* Apply automated fixes with one click.
* Download detailed PDF reports for records or sharing.

* **MCP Integration**:

* Full **MCP client support** (Claude Desktop, VSCode, etc.).
* Exposes **prompts, tools, and endpoints** for agent automation.
* Secure API key authentication for Gemini API access.

---

## Quick Start

### Using Gradio UI

1. Add your **Gemini API Key** in the secret configuration.
2. Upload a **log file** or select one from the server.
3. Click **Analyze Selected File** — the agent generates a summary, detects issues, and suggests fixes.
4. Optionally, select an **action** from the dropdown to automatically apply patches.
5. Download the **PDF report** for reference.

### Using MCP Clients

1. Point your MCP client to the **AgentOpsMCP Gradio URL**:
`https://your-space-name.hf.space/gradio_api/mcp/`
2. Discover available prompts and tools:

* `analyze_log_file`
* `generate_report`
* `apply_fix_action`
3. Call the tools programmatically with your input files.

---

## System Architecture

* **File Server**: Stores and provides access to uploaded logs.
* **Executor Server**: Applies automated actions based on agent recommendations.
* **Memory Server**: Maintains agent context and state across sessions.
* **Gemini API**: Provides reasoning, planning, and suggestions.
* **LlamaIndex (Optional)**: Summarizes logs for enhanced insights.
* **Gradio UI**: Central interface for interacting with agents and monitoring results.

---

## Dependencies

* `gradio==4.40.0`
* `fastapi`
* `uvicorn[standard]`
* `requests`
* `reportlab`
* `llama-index`

---

## License

MIT License — Original work created for **MCP’s 1st Birthday Hackathon (Nov 2025)**.

Files changed (1) hide show
  1. README.md +5 -1
README.md CHANGED
@@ -7,6 +7,10 @@ sdk: gradio
7
  sdk_version: 6.0.1
8
  app_file: app.py
9
  pinned: false
 
 
 
 
10
  ---
11
 
12
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
7
  sdk_version: 6.0.1
8
  app_file: app.py
9
  pinned: false
10
+ short_description: Autonomous AI agent platform for analyzing logs.
11
+ tags:
12
+ - building-mcp-track-consumer
13
+ - building-mcp-track-creative
14
  ---
15
 
16
+ Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference