# Devparana Incident Agent Mcps > Projeto criado para Talk no DevPR 2025 - **Type:** MCP server - **Install:** `agentstack add mcp-gabriel-dantas98-devparana-incident-agent-mcps` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [gabriel-dantas98](https://agentstack.voostack.com/s/gabriel-dantas98) - **Installs:** 0 - **Category:** [Integrations](https://agentstack.voostack.com/c/integrations) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [gabriel-dantas98](https://github.com/gabriel-dantas98) - **Source:** https://github.com/gabriel-dantas98/devparana-incident-agent-mcps - **Website:** https://docs.google.com/presentation/d/1caZhQFIXv2K4e1ljIR9I85Xv51vegV3-S64tanx4Q4M/ ## Install ```sh agentstack add mcp-gabriel-dantas98-devparana-incident-agent-mcps ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # �� VibeDebugger - Incident Assistant for Oncallers with MCPs **AI-powered incident response assistant built with LangGraph ReAct agents and Model Context Protocol (MCP) for DevPR 2025 conference.** 📊 **Presentation:** https://docs.google.com/presentation/d/1caZhQFIXv2K4e1ljIR9I85Xv51vegV3-S64tanx4Q4M/edit?usp=sharing ## 🎯 Quick Start ```bash # 1. Setup Kubernetes cluster and all services make setup # 2. Configure local DNS (requires sudo) make setup-hosts # 3. Copy environment variables cp .env.example .env # Edit with your tokens # 4. Install Python dependencies uv install # 5. Launch Discord bot python -m src.vibedebugger_discord.chatbot ``` ## 📋 Prerequisites - **[Docker](https://docs.docker.com/get-docker/)** (v20.10+) - Container runtime - **[Kind](https://kind.sigs.k8s.io/docs/user/quick-start/#installation)** (v0.20+) - Local Kubernetes clusters - **[kubectl](https://kubernetes.io/docs/tasks/tools/)** (v1.28+) - Kubernetes CLI - **[k9s](https://k9scli.io/topics/install/)** (optional) - Terminal UI for Kubernetes - **[Python](https://www.python.org/downloads/)** (3.10+) - Agent runtime - **[uv](https://docs.astral.sh/uv/getting-started/installation/)** - Fast Python package manager - **[Node.js](https://nodejs.org/en/download/)** (v20) via [nvm](https://github.com/nvm-sh/nvm#installing-and-updating) - For Backstage only - **[Discord Bot Token](https://discord.com/developers/docs/getting-started)** - For chat interface ## 🛠️ Available Commands ### Main Makefile ```bash make agent PROMPT="Your question" # Run agent from terminal ``` ### Cluster Management (`cluster/Makefile`) | Command | Description | |---------|-------------| | `make setup` | Create Kind cluster with all services (ArgoCD, Prometheus, Grafana, Backstage) | | `make teardown` | Destroy cluster and cleanup | | `make setup-hosts` | Configure `*.localdev.me` domains in `/etc/hosts` | | `make status` | Check health of all components | | `make validate` | Run validation tests | | `make port-forward` | Expose all services locally | | `make get-passwords` | Retrieve admin credentials | | `make deploy-sample` | Deploy nginx sample app for testing | | `make logs-` | View logs (argocd/prometheus/grafana/backstage/discord-bot) | ## 📁 Project Structure ``` hello-langrafo/ ├── src/ # Agent source code │ ├── agent/ # LangGraph ReAct agent core │ │ ├── graph.py # Main agent orchestration │ │ └── constants.py # System prompts and configurations │ ├── tools/ # MCP tool implementations │ │ ├── k8s.py # Kubernetes operations │ │ ├── prometheus.py # Metrics and alerts │ │ ├── argocd.py # GitOps management │ │ └── backstage.py # Service catalog │ ├── mcps/ # MCP server declarations │ └── vibedebugger_discord/ # Discord bot interface │ └── chatbot.py # Bot implementation ├── cluster/ # Kubernetes infrastructure │ ├── resources/ # K8s manifests │ │ ├── argocd/ # GitOps deployment configs │ │ ├── backstage/ # Developer portal │ │ ├── grafana/ # Dashboards and visualizations │ │ ├── prometheus/ # Monitoring and alerting │ │ └── sample-apps/ # Test applications │ ├── scripts/ # Automation scripts │ └── Makefile # Cluster management commands ├── scripts/ # Helper utilities │ └── agent_cli.py # Terminal interface for agent ├── assets/ # Documentation images ├── docker-compose.yml # Langfuse observability stack ├── langgraph.json # LangGraph configuration ├── pyproject.toml # Python dependencies └── uv.lock # Locked dependencies ``` ## 🚀 Service Access After `make setup`, services are available at: | Service | URL | Default Credentials | |---------|-----|---------------------| | **ArgoCD** | http://argocd.localdev.me | admin / (run `make get-passwords`) | | **Backstage** | http://backstage.localdev.me | No auth required | | **Grafana** | http://grafana.localdev.me | admin / admin | | **Prometheus** | http://prometheus.localdev.me | No auth required | > **Note**: Run `make setup-hosts` once to configure local DNS ## 💬 Usage Examples ### Via Discord Bot 1. Configure `.env` with your Discord bot token 2. Run `python -m src.vibedebugger_discord.chatbot` 3. Send messages in Discord channel ### Via Terminal ```bash # Direct query make agent PROMPT="Help me investigate nginx-sample in apps namespace" # Or using the CLI script python scripts/agent_cli.py "Check pod status in all namespaces" ``` ## 🔧 Configuration Create `.env` file with: ```bash # Required OPENAI_API_KEY=sk-... DISCORD_BOT_TOKEN=... DISCORD_CHANNEL_ID=... # Optional (uses defaults) PROMETHEUS_URL=http://localhost:9090 ARGOCD_SERVER=localhost:8080 BACKSTAGE_URL=http://localhost:7007 ``` ## 📸 Demonstrations Click to view screenshots ### K9s Cluster Overview ### Discord Alert from Prometheus ### VibeDebugger Bot Response ## 🏗️ Architecture - **ReAct Agent**: Reasoning + Acting loop with LangGraph - **MCP Tools**: Direct integrations with K8s, Prometheus, ArgoCD, Backstage - **Local Kind Cluster**: Full observability stack for testing - **Discord Interface**: Real-time incident response chat ## 📝 License MIT - See [LICENSE](LICENSE) file for details ## 🤝 Contributing This project was created for DevPR Conference 2025. Feel free to fork and adapt for your needs! --- **Built with ❤️ by [Gabriel Dantas](https://gdantas.com.br)** ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [gabriel-dantas98](https://github.com/gabriel-dantas98) - **Source:** [gabriel-dantas98/devparana-incident-agent-mcps](https://github.com/gabriel-dantas98/devparana-incident-agent-mcps) - **License:** MIT - **Homepage:** https://docs.google.com/presentation/d/1caZhQFIXv2K4e1ljIR9I85Xv51vegV3-S64tanx4Q4M/ Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** yes - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-gabriel-dantas98-devparana-incident-agent-mcps - Seller: https://agentstack.voostack.com/s/gabriel-dantas98 - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.