Source code for airflow.providers.common.ai.example_dags.example_mcp

# Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements.  See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership.  The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License.  You may obtain a copy of the License at
#
#   http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied.  See the License for the
# specific language governing permissions and limitations
# under the License.
"""Example DAGs demonstrating MCP server integration with AgentOperator."""

from __future__ import annotations

from airflow.providers.common.ai.operators.agent import AgentOperator
from airflow.providers.common.ai.toolsets.mcp import MCPToolset
from airflow.providers.common.compat.sdk import dag

# ---------------------------------------------------------------------------
# 1. MCPToolset with Airflow connection (recommended for production)
# ---------------------------------------------------------------------------


# [START howto_toolset_mcp_connection]
@dag

[docs]
def example_mcp_toolset():
    """Use an MCP server configured via an Airflow connection."""
    AgentOperator(
        task_id="mcp_agent",
        prompt="What tools are available? Run the hello tool.",
        llm_conn_id="pydantic_ai_default",
        system_prompt="You are a helpful assistant with access to MCP tools.",
        toolsets=[
            MCPToolset(mcp_conn_id="my_mcp_server"),
        ],
    )



# [END howto_toolset_mcp_connection]

example_mcp_toolset()


# ---------------------------------------------------------------------------
# 2. Multiple MCP servers with tool prefixes
# ---------------------------------------------------------------------------


# [START howto_toolset_mcp_multiple]
@dag

[docs]
def example_mcp_multiple_servers():
    """Combine multiple MCP servers with prefixes to avoid tool name collisions."""
    AgentOperator(
        task_id="multi_mcp_agent",
        prompt="Get the weather in London and run a Python calculation: 2**10",
        llm_conn_id="pydantic_ai_default",
        system_prompt="You have access to weather and code execution tools.",
        toolsets=[
            MCPToolset(mcp_conn_id="weather_mcp", tool_prefix="weather"),
            MCPToolset(mcp_conn_id="code_runner_mcp", tool_prefix="code"),
        ],
    )



# [END howto_toolset_mcp_multiple]

example_mcp_multiple_servers()


# ---------------------------------------------------------------------------
# 3. Direct PydanticAI MCP servers (no Airflow connection needed)
# ---------------------------------------------------------------------------
# AgentOperator accepts any PydanticAI AbstractToolset, including MCP servers
# directly. Use this for prototyping or when you want full PydanticAI control.
#
#   from pydantic_ai.mcp import MCPServerStreamableHTTP, MCPServerStdio
#
#   AgentOperator(
#       task_id="direct_mcp",
#       prompt="What tools are available?",
#       llm_conn_id="pydantic_ai_default",
#       toolsets=[
#           MCPServerStreamableHTTP("http://localhost:3001/mcp"),
#           MCPServerStdio("uvx", args=["mcp-run-python"]),
#       ],
#   )