🤖 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```mermaid
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**
1. **🌟 Clone the Repository**```bash
git clone https://github.com/yourusername/mcpwheather.git
cd mcpwheather
```
2. **📦 Install Dependencies**```bash
uv sync
```
3. **🔑 Configure API Key**```bash
echo "GROQ_API_KEY=your_groq_api_key_here" > .env
```
4. **🚀 Launch the Agent**```bash
uv run app.py
```
5. **💬 Start Chatting!**```
you: open google.com and search for AI automation
```
---
## 🎮 Usage Examples
### 🌐 **Web Automation**```bash
# 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```bash
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**```env
# 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```python
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**```bash
# Run from project directory
uv run app.py
# Install globally
pip install -e .
mcp-agent
🐳 Docker Deployment```dockerfile
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"]
``````bash
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```text
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```bash
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
- [ ] ☁️ **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**
1. 🍴 **Fork the repository**
2. 🌿 **Create a feature branch**
3. 💻 **Make your changes**
4. 🧪 **Add tests**
5. 📤 **Submit a pull request**
### 🎨 **Development Setup**```bash
# 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!
