FastAPI SSE MCP Случайный

Сервер FastAPI, реализующий протокол контекста модели (MCP) с использованием Server-Sent Events (SSE) для потоковой связи. Этот проект предоставляет различные утилиты, включая генерацию случайных чисел, генерацию изображений с использованием Azure OpenAI DALL-E и генерацию подкастов на основе ИИ.

Функции

• События, отправленные сервером (SSE) для потоковой передачи данных в реальном времени

• Реализация протокола контекста модели (MCP) для использования структурированного инструмента

• Несколько вспомогательных инструментов :

  • Инструмент и ресурсы Echo

  • Генератор случайных чисел

  • Генерация изображений через Azure OpenAI DALL-E 3

  • Генерация подкастов с помощью ИИ

  • «Инструмент для размышлений» для рефлексивных ответов

Related MCP server: AI Agent MCP Server

Предпосылки

• Питон 3.10+

• Доступ к API Azure OpenAI (для создания изображений)

Установка

1. Клонируйте репозиторий:

git clone <repository-url>
cd fastapi_sse_mcp_random

2. Установите зависимости:

pip install -r requirements.txt

Или с помощью uv :

uv pip install -e .

Использование

Запуск сервера

Запустите сервер с помощью:

python main.py

Сервер запустится по адресу http://0.0.0.0:8000

Доступные конечные точки

• GET / : Конечная точка проверки работоспособности

• GET /sse/ : конечная точка соединения SSE

• POST /messages/ : Конечная точка для клиентских сообщений

Доступные инструменты

Эхо-инструмент

{
  "name": "echo_tool",
  "parameters": {
    "message": "Hello, world!"
  }
}

Генератор случайных чисел

{
  "name": "random_number",
  "parameters": {
    "min_value": 1,
    "max_value": 100
  }
}

Генерация изображения

{
  "name": "generate_image",
  "parameters": {
    "prompt": "A beautiful landscape with mountains and a lake"
  }
}

Генерация подкастов

{
  "name": "generate_podcast",
  "parameters": {
    "prompt": "The future of artificial intelligence",
    "duration": 5,
    "name1": "Mark",
    "voice1": "Thomas",
    "name2": "Sophia",
    "voice2": "Emily"
  }
}

Инструмент для размышлений

{
  "name": "think_tool",
  "parameters": {
    "input": "What are the implications of quantum computing?"
  }
}

Структура проекта

• main.py : Основное приложение FastAPI и реализация инструментов MCP

• sse.py : реализация событий, отправленных сервером (SSE)

• pyproject.toml : метаданные и зависимости проекта

• requirements.txt : список основных зависимостей

Зависимости

• FastAPI: веб-фреймворк для создания API

• MCP: реализация протокола контекста модели

• OpenAI: Клиент для служб Azure OpenAI

• Uvicorn: ASGI-сервер для запуска приложений FastAPI

• Запросы: HTTP-библиотека для вызовов API

Лицензия

[Укажите здесь вашу лицензию]

Внося вклад

[Инструкции по внесению вклада в проект]