MCP AI Agents

User Natural Language Query
    ↓
OpenAI GPT-4o (Query Understanding)
    ↓
MCP Protocol Layer
    ↓
GitHub MCP Server (Docker Container)
    ↓
GitHub API
├─ Repository data
├─ Issues and PRs
├─ Code statistics
├─ Activity metrics
└─ Collaboration data
    ↓
Structured Response

Natural Language Command
    ↓
LLM (OpenAI/Anthropic)
├─ Understand intent
├─ Plan actions
└─ Generate commands
    ↓
MCP Protocol
    ↓
MCP-Agent Framework
    ↓
Playwright MCP Server (Node.js)
    ↓
Headless Browser
├─ Navigate pages
├─ Click elements
├─ Fill forms
├─ Take screenshots
└─ Extract content
    ↓
Results + Screenshots

from mcp_agent import MCPAgent
from playwright import async_api

# Initialize browser agent
agent = MCPAgent(
    model="gpt-4o",
    mcp_servers={
        "playwright": {
            "command": "npx",
            "args": ["-y", "@modelcontextprotocol/server-playwright"]
        }
    }
)

# Execute natural language commands
result = await agent.run(
    "Go to example.com and extract the main heading"
)

# Results include screenshots and extracted data
screenshot = result.artifacts["screenshot"]
content = result.content

"What's on my Notion page?"
"Add a new paragraph saying 'Meeting notes for today'"
"Create a bullet list with three items: Apple, Banana, Orange"
"Add a comment to the first paragraph saying 'This looks good!'"
"Search for any mentions of meetings"
"Summarize our conversation so far"
"Create a table with columns Name, Role, Status"

# Each session maintains context
session_id = generate_session_id()
user_id = generate_user_id()

# Agent remembers previous interactions
agent = NotionMCPAgent(
    session_id=session_id,
    user_id=user_id
)

# Multi-turn conversation
agent.run("Add a heading 'Project Plan'")
agent.run("Under that, add three bullet points")
agent.run("Now add a table below with tasks")

Example: Automated Project Management

"Research latest React features, create GitHub issue, 
and schedule team meeting to discuss"
    ↓
Perplexity Agent
└─ Research React updates
    ↓
GitHub Agent
└─ Create issue with findings
    ↓
Calendar Agent
└─ Schedule team meeting
    ↓
Gmail Agent
└─ Send meeting invitation with issue link

from agno import Agent
from agno.mcp import MCPServer

# Configure MCP servers
mcp_servers = {
    "github": MCPServer(
        command="npx",
        args=["-y", "@modelcontextprotocol/server-github"],
        env={"GITHUB_TOKEN": github_token}
    ),
    "perplexity": MCPServer(
        command="npx",
        args=["-y", "@modelcontextprotocol/server-perplexity"],
        env={"PERPLEXITY_API_KEY": perplexity_key}
    ),
    # ... more servers
}

# Create multi-service agent
agent = Agent(
    model="gpt-4o",
    mcp_servers=mcp_servers,
    memory=True,
    session_id=session_id
)

# Agent can use all connected services
response = agent.run(
    "Search for AI news and create GitHub issues for interesting articles"
)

from mcp_agent import MCPAgent

# Simple MCP agent with one server
agent = MCPAgent(
    model="gpt-4o",
    mcp_servers={
        "github": {
            "command": "npx",
            "args": ["-y", "@modelcontextprotocol/server-github"],
            "env": {"GITHUB_TOKEN": token}
        }
    }
)

response = agent.run("Show my recent pull requests")

# Agent with multiple MCP servers
agent = MCPAgent(
    model="gpt-4o",
    mcp_servers={
        "github": github_server_config,
        "notion": notion_server_config,
        "calendar": calendar_server_config
    }
)

# Agent can use all connected services
response = agent.run(
    "Create a Notion page with my GitHub stats and schedule a review meeting"
)

# Define custom MCP server
custom_server = {
    "command": "python",
    "args": ["-m", "my_mcp_server"],
    "env": {
        "API_KEY": api_key,
        "BASE_URL": base_url
    }
}

agent = MCPAgent(
    model="gpt-4o",
    mcp_servers={"custom": custom_server}
)

import asyncio

async def run_parallel_mcp_tasks():
    # Execute multiple MCP operations in parallel
    tasks = [
        agent.run_async("Get GitHub issues"),
        agent.run_async("Check calendar availability"),
        agent.run_async("Search latest news")
    ]
    
    results = await asyncio.gather(*tasks)
    return results