MCP vs function calling: когда что выбирать

"""
Гибридный агент:
- MCP для инфраструктурных инструментов (файлы, github)
- Function calling для бизнес-логики (форматирование отчёта, валидация)
"""
import anthropic
from mcp import ClientSession
from mcp.client.stdio import stdio_client

# Бизнес-инструменты — inline через function calling
BUSINESS_TOOLS = [
    {
        "name": "format_report",
        "description": "Форматирует данные в Markdown-отчёт по шаблону компании",
        "input_schema": {
            "type": "object",
            "properties": {
                "title":   {"type": "string"},
                "data":    {"type": "string"},
                "section": {"type": "string", "enum": ["weekly", "monthly", "quarterly"]}
            },
            "required": ["title", "data", "section"]
        }
    }
]

def format_report(title: str, data: str, section: str) -> str:
    # Логика форматирования специфична для этого приложения
    return f"# {title}\n\n**Период:** {section}\n\n{data}"


async def run_hybrid_agent(task: str):
    # Подключаемся к MCP для инфраструктурных инструментов
    async with stdio_client(
        command="python", args=["mcp_server.py"]
    ) as (read, write):
        async with ClientSession(read, write) as mcp_session:
            await mcp_session.initialize()

            # Получаем MCP-инструменты динамически
            mcp_tools_result = await mcp_session.list_tools()
            mcp_tools = [
                {
                    "name": t.name,
                    "description": t.description,
                    "input_schema": t.inputSchema
                }
                for t in mcp_tools_result.tools
            ]

            # Объединяем: MCP + business tools
            all_tools = mcp_tools + BUSINESS_TOOLS

            client = anthropic.Anthropic()
            messages = [{"role": "user", "content": task}]

            while True:
                resp = client.messages.create(
                    model="claude-opus-4-6",
                    max_tokens=4096,
                    tools=all_tools,
                    messages=messages,
                )
                messages.append({"role": "assistant", "content": resp.content})

                if resp.stop_reason != "tool_use":
                    break

                tool_results = []
                for block in resp.content:
                    if block.type != "tool_use":
                        continue

                    if block.name == "format_report":
                        # Бизнес-инструмент — вызываем локально
                        result = format_report(**block.input)
                    else:
                        # MCP-инструмент — вызываем через протокол
                        mcp_result = await mcp_session.call_tool(
                            block.name, block.input
                        )
                        result = mcp_result.content[0].text

                    tool_results.append({
                        "type": "tool_result",
                        "tool_use_id": block.id,
                        "content": result,
                    })

                messages.append({"role": "user", "content": tool_results})

            return resp.content[0].text