🤖 MCP Agent - Universal AI Automation

The Ultimate AI Agent powered by Model Context Protocol (MCP)

Next-generation AI automation at your fingertips!

🌟 What is MCP Agent?

MCP Agent is a revolutionary AI automation tool that combines the power of:

🧠 Advanced Language Models (Groq, OpenAI, Gemini)
🌐 Browser Automation (Playwright)
🔌 Model Context Protocol (MCP) servers
💬 Conversational AI with memory

Imagine having a personal AI assistant that can browse the web, fill forms, take screenshots, and execute complex tasks - all through natural conversation!

🚀 Key Features

🎯 Core Capabilities

Feature	Description	Power Level
🤖 Conversational AI	Natural language interaction with memory	⚡⚡⚡⚡⚡
🌐 Browser Control	Full web automation with Playwright	⚡⚡⚡⚡⚡
🔌 MCP Integration	Connect to any MCP server	⚡⚡⚡⚡
🧠 Smart Memory	Context-aware conversations	⚡⚡⚡⚡
⚡ Multi-LLM	Switch between AI models	⚡⚡⚡
📱 Cross-Platform	Works on Windows, Mac, Linux	⚡⚡⚡⚡⚡

🎪 What Can It Do?

📸 Take screenshots of any website
🔍 Search and browse the web automatically
📝 Fill forms and submit data
🛒 Automate shopping and bookings
📊 Extract data from websites
🎯 Test web applications
📧 Automate email tasks
🗂️ Organize files and folders

🛠️ Tech Stack

graph TD
    A[MCP Agent] --> B[LangChain]
    A --> C[MCP Protocol]
    A --> D[Playwright]
    A --> E[Groq LLM]
    
    B --> F[Python 3.13+]
    C --> G[MCP Servers]
    D --> H[Browser Control]
    E --> I[AI Models]
    
    style A fill:#ff6b6b,stroke:#333,stroke-width:4px
    style B fill:#4ecdc4,stroke:#333,stroke-width:2px
    style C fill:#45b7d1,stroke:#333,stroke-width:2px
    style D fill:#96ceb4,stroke:#333,stroke-width:2px
    style E fill:#ffeaa7,stroke:#333,stroke-width:2px

🏗️ Architecture Components

🧠 Core Engine: Python 3.13+ with asyncio
🔗 Framework: LangChain for AI orchestration
🌐 Protocol: Model Context Protocol (MCP)
🎭 Automation: Playwright for browser control
💭 Models: Groq (Llama 3.1), OpenAI, Google Gemini
📦 Management: UV package manager

🚀 Quick Start

📋 Prerequisites

Python 3.13+ 🐍
Node.js (for MCP servers) 📦
UV package manager ⚡
Groq API Key 🔑

⚡ 5-Minute Setup

🌟 Clone the Repository

git clone https://github.com/yourusername/mcpwheather.git
cd mcpwheather

📦 Install Dependencies
```
uv sync
```

🔑 Configure API Key

echo "GROQ_API_KEY=your_groq_api_key_here" > .env

🚀 Launch the Agent
```
uv run app.py
```

💬 Start Chatting!

you: open google.com and search for AI automation

🎮 Usage Examples

🌐 Web Automation

# Browse and search
you: open google.com and search for "weather in Tokyo"

# Take screenshots
you: navigate to github.com and take a screenshot

# Fill forms
you: go to example.com/contact and fill out the form with name "John" and email "john@example.com"

# Extract data
you: visit amazon.com and find the price of the latest iPhone

🤖 Advanced Tasks

# Multi-step workflows
you: book a flight from New York to London for next week, find the cheapest option

# Data collection
you: visit reddit.com/r/technology and get the top 5 post titles

# Testing
you: test the login functionality of example.com with username "test" and password "test123"

🎯 Interactive Commands

Command	Action	Emoji
`exit` / `quit`	End session	👋
`clear`	Clear memory	🧹
`memory`	View history	🧠
`help`	Show help	🆘

🔧 Configuration

🎛️ Environment Variables

# Required
GROQ_API_KEY=your_groq_api_key_here

# Optional - Additional LLMs
OPENAI_API_KEY=your_openai_key_here
GOOGLE_API_KEY=your_google_key_here

# Optional - MCP Server Tokens
GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token

🔌 Custom MCP Servers

config = {
    "mcpServers": {
        "playwright": {
            "command": "npx",
            "args": ["-y", "@playwright/mcp@latest"]
        },
        "filesystem": {
            "command": "npx",
            "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
        },
        "github": {
            "command": "npx",
            "args": ["-y", "@modelcontextprotocol/server-github"],
            "env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "your_token"}
        }
    }
}

🌍 Deployment Options

🏠 Local Installation

# Run from project directory
uv run app.py

# Install globally
pip install -e .
mcp-agent

🐳 Docker Deployment

FROM python:3.13-slim
WORKDIR /app
COPY --from=ghcr.io/astral-sh/uv:latest /uv /bin/uv
COPY . .
RUN uv sync --frozen
CMD ["uv", "run", "app.py"]

docker build -t mcp-agent .
docker run -it --env-file .env mcp-agent

☁️ Cloud Deployment

AWS Lambda 🚀
Google Cloud Run ☁️
Azure Functions 🔷
Railway 🚂
Render 🎨

📁 Project Structure

mcpwheather/
├── 📄 app.py              # Main application entry point
├── 📄 pyproject.toml      # Project configuration
├── 📄 .env                # Environment variables
├── 📄 .python-version     # Python version
├── 📄 uv.lock             # Dependency lock file
├── 📄 README.md           # Project documentation
└── 📄 .gitignore          # Git ignore rules

🔍 Troubleshooting

🐛 Common Issues

Problem	Solution	Status
`ModuleNotFoundError`	Run `uv sync`	✅ Fixed
API Key Issues	Check `.env` file	✅ Fixed
Browser Not Starting	Install Node.js	✅ Fixed
Permission Denied	Use `chmod +x`	✅ Fixed
Docker Build Fails	Check Dockerfile	✅ Fixed

🆘 Get Help

# Check dependencies
uv tree

# Test API connection
python -c "from langchain_groq import ChatGroq; print('✅ API OK')"

# Verify MCP server
npx @playwright/mcp@latest --help

🚀 Roadmap

🎯 Coming Soon

🌐 Web Interface - React-based dashboard
📱 Mobile App - iOS and Android support
🔌 Plugin Store - Community plugins
📊 Analytics - Usage tracking and insights
🔄 Multi-Agent - Parallel task execution
🎨 Themes - Customizable personalities
🌍 Multi-language - International support
☁️ Cloud Sync - Cross-device synchronization

💡 Future Ideas

🧠 AI Training - Custom model fine-tuning
🔗 API Integration - Connect to any service
📈 Business Intelligence - Automated reporting
🎮 Game Automation - Bot development tools
🏢 Enterprise Features - Team collaboration

🤝 Contributing

We welcome contributions! 🎉

📝 How to Contribute

🍴 Fork the repository
🌿 Create a feature branch
💻 Make your changes
🧪 Add tests
📤 Submit a pull request

🎨 Development Setup

# Clone your fork
git clone https://github.com/yourusername/mcpwheather.git
cd mcpwheather

# Set up development environment
python -m venv .venv
source .venv/bin/activate
uv sync --dev

# Run tests
uv run pytest

# Start coding! 🚀

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

🧠 LangChain - For the amazing AI framework
🔌 MCP Protocol - For the standardized AI communication
🎭 Playwright - For powerful browser automation
⚡ Groq - For lightning-fast AI inference
🐍 Python - The best programming language
🎨 Animated Emojis - For the beautiful icons

📞 Contact & Support

📧 Email: support@mcp-agent.com
💬 Discord: Join our community
🐦 Twitter: @MCP_Agent
📖 Documentation: docs.mcp-agent.com
🐛 Issues: GitHub Issues

Made with ❤️ by the MCP Agent Team

Powering the future of AI automation

If you love this project, give us a ⭐ on GitHub!

Name		Name	Last commit message	Last commit date
Latest commit History 4 Commits
mcpserver		mcpserver
mcpwheather		mcpwheather
MCP_SERVER_TEST_REPORT.md		MCP_SERVER_TEST_REPORT.md
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

🤖 MCP Agent - Universal AI Automation

🌟 What is MCP Agent?

🚀 Key Features

🎯 Core Capabilities

🎪 What Can It Do?

🛠️ Tech Stack

🏗️ Architecture Components

🚀 Quick Start

📋 Prerequisites

⚡ 5-Minute Setup

🎮 Usage Examples

🌐 Web Automation

🤖 Advanced Tasks

🎯 Interactive Commands

🔧 Configuration

🎛️ Environment Variables

🔌 Custom MCP Servers

🌍 Deployment Options

🏠 Local Installation

🐳 Docker Deployment

☁️ Cloud Deployment

📁 Project Structure

🔍 Troubleshooting

🐛 Common Issues

🆘 Get Help

🚀 Roadmap

🎯 Coming Soon

💡 Future Ideas

🤝 Contributing

📝 How to Contribute

🎨 Development Setup

📄 License

🙏 Acknowledgments

📞 Contact & Support

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages