🌐 MCP Agents

MCP Agents is an AI-powered interactive browser assistant built with Streamlit, OpenAI, and Puppeteer using the Model Context Protocol (MCP). Type natural language commands like "Go to Wikipedia and search for Mars" and the app will navigate, click, scroll, and even extract content — all hands-free.

---

🚀 Features

• Talk to the Web — Interact with websites using simple English commands
• Visual Automation — Take screenshots, click elements, and scroll pages effortlessly
• Flexible Agent System — Powered by the modular MCP Agent framework
• Secure Integration — API keys stored safely with optional secrets config
• Fully Interactive UI — See command results directly in the app interface

---

🎯 Use Cases

• 💼 Product scraping, news summarization, automated browsing workflows
• 🧪 Educational bots that walk through websites
• 📰 Daily content extraction from dynamic pages

---

⚙️ Requirements

• Python 3.8 or newer
• Node.js + npm (for Puppeteer server)
• OpenAI API key

---

⚡ Quick Start

# Clone and enter the project
$ git clone https://github.com/your-username/mcp-agents.git
$ cd mcp-agents

# Install Python dependencies
$ pip install -r requirements.txt

# Verify Node.js setup
$ node --version && npm --version

# Optional: Start Puppeteer agent
$ npx -y @modelcontextprotocol/server-puppeteer

# Run the app
$ streamlit run main.py

Visit http://localhost:8501 in your browser.

---

🔐 Configure Secrets

Create a file named mcp_agent.secrets.yaml:

openai:
  api_key: "your-openai-api-key"

➡️ Make sure this file is listed in .gitignore to avoid leaking credentials.

---

💬 Example Commands You Can Try

• "Go to www.wikipedia.org"
• "Search for black holes and summarize the page"
• "Click on the first heading"
• "Take a screenshot of the hero section"
• "Scroll down and extract all h2 titles"

---

📁 Project Overview

mcp-agents/
├── main.py                     # Streamlit application
├── requirements.txt           # Python dependencies
├── README.md                  # This file
├── mcp_agent.config.yaml      # Config for Puppeteer + agent setup
├── mcp_agent.secrets.yaml     # API secrets (ignored from Git)
├── .gitignore                 # File exclusions

---

📄 License

Licensed under the MIT License.

---

🙋‍♂️ Created By

Built with ❤️ by Harsh. Powered by the open agent framework from MCP and inspired by LastMileAI tooling.

---

👨‍💻 Want to build your own AI-powered automation agent? Fork this repo and start customizing!