What is Mcp Agents

MCP-Agents is an AI-powered browser automation tool that allows users to interact with websites using natural language commands. It is built with Streamlit, OpenAI, and Puppeteer, utilizing the Model Context Protocol (MCP) for seamless navigation and content extraction.

Use cases

Use cases for MCP-Agents include product scraping, news summarization, creating educational bots that guide users through websites, and daily content extraction from dynamic pages.

How to use

To use MCP-Agents, clone the project repository, install the required Python dependencies, verify your Node.js setup, and run the application using Streamlit. You can then interact with the browser by typing natural language commands.

Key features

Key features of MCP-Agents include the ability to interact with the web using simple English commands, visual automation capabilities such as taking screenshots and clicking elements, a flexible agent system powered by the MCP framework, secure integration for API keys, and a fully interactive user interface.

Where to use

MCP-Agents can be used in various fields including web scraping, educational tools, automated browsing workflows, and content extraction from dynamic web pages.

🌐 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!