Практическое использование
AI агентов и MCP протокола

От теории к рабочему коду за 30 минут

Мухаммад Абдугафаров
11 октября 2025
Худжанд, Таджикистан

Slides QR Code

Сканируйте для просмотра слайдов

Обо мне 👨‍💻

Мухаммад Абдугафаров

Имя: Мухаммад Абдугафаров

Роль: Тимлид в SilkRoad Professionals

Опыт: 8 лет в IT

Интересы: AI, продуктовая разработка

Что такое LLM? 🧠

Large Language Model — Большая языковая модель

💡 LLM = "Мозг", который понимает человеческий язык

Что умеют LLM? ✨

Могут:

  • Понимать текст, изображения, аудио
  • Генерировать ответы
  • Анализировать данные
  • Писать код
  • Переводить языки

Не могут:

  • Выполнять реальные действия
  • Использовать внешние инструменты
  • Изменять состояние систем
  • Работать с актуальными данными

💡 LLM умеет думать, но не умеет делать

От LLM к AI агенту 🤖

LLM (Просто модель)
    ↓
    + Инструменты (Tools)
    + Память (Memory)
    + Способность принимать решения
    ↓
AI Agent (Может делать)

AI Agent = LLM + возможность взаимодействовать с миром

Что такое AI агент? 🤖

Компоненты:

  • 🧠 LLM (мозг)
  • 🛠️ Инструменты (руки)
  • 💾 Память (контекст)
  • 🎯 Цель (задача)

Возможности:

  • Выполняет действия
  • Принимает решения
  • Использует инструменты
  • Решает сложные задачи

Агент = Не просто чат, а помощник, который может делать!

Проблема 🤔

LLM сами по себе ограничены

Вопрос: Как дать LLM возможность использовать инструменты?

Решение: MCP ✨

Model Context Protocol

MCP = USB для AI инструментов

Что такое MCP? 🔌

Архитектура системы 🏗️

Архитектура системы

Зачем нужен MCP? 💡

С MCP ✓

  • Стандартизированный протокол
  • Plug-and-play инструменты
  • Работает с любой LLM
  • Легко расширяется

Без MCP ✗

  • Кастомная интеграция
  • Для каждого инструмента
  • Жёстко привязан к LLM
  • Тяжело поддерживать

Сегодняшнее демо 🎬

Expense Tracker Agent

Архитектура системы 🔧

Пользователь → AI Agent (Agno) → MCP Server → FastAPI → SQLite
                    ↓
              OpenAI GPT-4
                    ↓
            Обрабатывает запрос
            Выбирает инструменты
            Форматирует ответ

Технологический стек 🛠️

MCP Server - код 💻

from fastapi import FastAPI
from fastapi_mcp import FastApiMCP

app = FastAPI()

# Это всё! 5 строк кода
mcp = FastApiMCP(
    app,
    name="Expense Tracker MCP"
)

# Автоматически преобразует все FastAPI роуты в MCP инструменты!

FastAPI Backend 🚀

@app.post("/transactions")
async def create_transaction(
    data: TransactionCreate
):
    return store.create(data)

# Обычный FastAPI роут
# Становится MCP инструментом автоматически
# AI может вызывать его через MCP

Настройка агента ⚙️

agent = Agent(
    name="Expense Tracker Agent",
    model=OpenAIChat(id="gpt-4"),
    
    # Подключаемся к MCP серверу
    tools=[MCPTools(
        url="http://localhost:9002/mcp"
    )],
    
    # Системные инструкции
    instructions=SYSTEM_PROMPT
)

🎬

ЖИВОЕ ДЕМО

Посмотрим, как это работает!

Под капотом 🔍

1. Пользователь: "Покажи мой баланс"
   ↓
2. GPT-4 думает:
   - Нужен инструмент: get_summary
   ↓
3. MCP вызов:
   POST /mcp/tools/get_summary
   ↓
4. FastAPI выполняет:
   SELECT SUM(...) FROM transactions
   ↓
5. Агент отвечает:
   "Ваш баланс: 5000.00"

Реальные применения 🌍

Преимущества в продакшене 📈

Попробуйте сами! 🚀

# Клонируйте репозиторий
git clone https://github.com/dev-muhammad/MCPAgent
cd MCPAgent

# Настройте
cp .env.example .env
# Добавьте OPENAI_API_KEY в .env

# Запустите
cd server && python start.py --mcp
cd server && python start.py --api
cd agent && python agent.py

Ресурсы 📚

Документация:

  • MCP: modelcontextprotocol.io
  • FastAPI-MCP: github.com/jlowin/fastapi-mcp
  • Agno: docs.agno.com

GitHub репозиторий:

Вопросы? 🤔

Спасибо за внимание! 🎉

1 / 24

Горячие клавиши ⌨️