🤖 MCP + CrewAI Agentic Integration 🚀

A powerful demonstration of Model Context Protocol (MCP) integrated with CrewAI orchestrations, featuring full observability through AgentOps and high-speed inference via Groq.

🌟 Overview

This project bridges the gap between context-aware tools and autonomous agents. It provides a custom MCP server for real-time external data (Weather, News, Notes) while leveraging CrewAI to orchestrate multi-agent workflows.

🏗️ Architecture

• MCP Layer: A FastMCP server exposing tools for real-time data retrieval.

• Agentic Layer: CrewAI agents specialized in Market Analysis and Research.

• Inference Layer: Ultra-fast LLMs (Llama 3.1) hosted on Groq.

• Observability Layer: AgentOps for tracing, cost management, and debugging.

✨ Key Features

🛠️ Custom MCP Server Tools

• ☀️ Weather Engine: Real-time meteorology data via WeatherAPI.

• 📰 News Intelligence: Global news retrieval via Serper (Google Search API).

• 📝 Contextual Notes: Locally persistent note management for long-term memory.

• � Auto-Summary: Intelligent summarization of collected context.

👥 Intelligence Crew

• 🔍 Market Researcher: Scours data to identify emerging trends.

• 📈 Data Analyst: Synthesizes research into actionable market insights.

• 🚀 Sequential Workflow: Fully orchestrated execution path for reliable results.

🛠️ Tech Stack

• Framework: CrewAI

• Server: FastMCP

• LLM Engine: Groq (Llama 3.1 8B/70B)

• Tracing: AgentOps

• Package Manager: uv

🚀 Getting Started

1. Prerequisites

Ensure you have the following installed:

• uv (Recommended) or Python 3.13+

• A valid Groq API Key

• A valid AgentOps API Key

• A Serper API Key (for News)

2. Installation

Clone the repository and sync dependencies:

git clone https://github.com/vad-007/MCP_Integration_crewai.git
cd MCP_Integration_crewai
uv sync

3. Configuration

Create a .env file in the root directory:

AGENTOPS_API_KEY=your_agentops_key
GROQ_API_KEY=your_groq_key
SERPER_API_KEY=your_serper_key
WEATHER_API_KEY=your_weather_key

4. Running the Project

🌐 Start the MCP Server

mcp dev main.py

🚢 Run the CrewAI Integration

python crewai_agentops_integration.py

🔍 Run Diagnostics

python test_agentops.py

📊 Observability with AgentOps

This project is fully instrumented. Every run generates a unique replay URL allowed you to:

• Watch Agent Self-Correction: See exactly how agents reason through tasks.

• Trace LLM Calls: Monitor every prompt and completion.

• Analyze Latency: Visualize the execution timeline of your crew.

Check your dashboard at: app.agentops.ai

📂 Project Structure

├── main.py                    # FastMCP Server implementation
├── crewai_agentops_integration.py # Main CrewAI orchestration
├── test_agentops.py           # Connectivity & Diagnostic tool
├── .env                       # Environment variables (private)
├── pyproject.toml             # Project configuration
├── uv.lock                    # Dependency lockfile
└── docs/                      # Troubleshooting & Optimization guides

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project

2. Create your Feature Branch (git checkout -b feature/AmazingFeature)

3. Commit your Changes (git commit -m 'Add some AmazingFeature')

4. Push to the Branch (git push origin feature/AmazingFeature)

5. Open a Pull Request

🛡️ License

Distributed under the MIT License. See LICENSE for more information.

Developed with ❤️ for the AI Community.