This repository provides a practical demonstration of integrating tools with AI agents using the Model Context Protocol (MCP) within the AutoGen framework.
Key Features Demonstrated:
- Dual MCP Integration: Shows how to connect an AutoGen agent to:
- A local tool server (
math_server.py) using Stdio transport. - A remote tool server (Apify's RAG Web Browser Actor) using Server-Sent Events (SSE) transport.
- A local tool server (
- Local Tool Example: A simple calculator (
add,multiply) running locally viamath_server.py. - Remote Tool Example: Leveraging Apify's RAG Web Browser Actor via their MCP Server for web searching and content retrieval.
- AutoGen Agent: An
AssistantAgentconfigured to utilize both sets of tools to answer user queries.
Goal: To illustrate the flexibility of MCP in enabling AI agents to access diverse tools, whether hosted locally or remotely, through standardized communication protocols (Stdio and SSE).
Scenario: The example agent answers two distinct questions:
- A math problem (
(3 + 5) x 12?), expected to use the localmath_server.py. - A request for recent news ("Summarise the latest news of Iran and US negotiations..."), expected to use the remote Apify web browsing tool.

- AutoGen: AI agent framework (autogen_agentchat, autogen_core, autogen_ext)
- MCP: Model Context Protocol for tool integration
- Python-dotenv: For environment variable management
- OpenAI API: For LLM capabilities
- Apify API: For web browsing capabilities
Follow these steps carefully to set up your environment: