Python MCP Agent Chatbot

Проект для класса по агентному ИИ, полностью написанный на Python. Groq отвечает за рассуждения модели, а локальный MCP-сервер предоставляет инструменты.

Архитектура

Browser -> FastAPI (Python) -> Groq -> MCP Client -> MCP Server (Python) -> Tool

Related MCP server: mcp-datecalc

Файлы

• app.py — веб-бэкенд FastAPI, цикл агента Groq и MCP-клиент

• mcp_server.py — Python MCP-сервер с тремя инструментами

• test_mcp.py — тест обнаружения MCP и вызова инструментов

• index.html — интерфейс чата в браузере

• pyproject.toml — зависимости Python

Запуск на Windows

uv sync --cache-dir .uv-cache
uv run --cache-dir .uv-cache uvicorn app:app --reload

Откройте http://127.0.0.1:8000.

Чтобы протестировать MCP без вызова Groq API:

uv run --cache-dir .uv-cache python test_mcp.py

Попробуйте эти вопросы:

• 25 * 8 + 10 calculate karo

• Karachi mein abhi kya time hai?

• Ahmed ki attendance kya hai?

Поток MCP

1. Функции в mcp_server.py регистрируются с помощью @mcp.tool().

2. app.py запускает этот MCP-сервер как локальный подпроцесс Python, используя stdio.

3. MCP-клиент вызывает list_tools(), чтобы Groq мог видеть доступные инструменты.

4. Groq выбирает инструмент и генерирует его аргументы.

5. MCP-клиент вызывает call_tool() и возвращает результат инструмента в Groq.

6. Groq преобразует результат в ответ на естественном языке.

Файл .env содержит ключ Groq и намеренно исключён из Git.