Moscow History Mcp2

🏛️ Moscow History MCP Server

Сервер для генерации исторического контента о Москве с использованием AI технологий.

🎯 Описание

Moscow History MCP Server - это полнофункциональный сервер для создания информативных и визуально привлекательных постов об истории Москвы. Сервер следует детальной инструкции по созданию контента и включает все этапы от сбора фактов до контроля качества.

🏗️ Архитектура

Компоненты:

• MCP Server - основной сервер для генерации контента
• API интеграции - Perplexity AI + OpenAI GPT
• Модели данных - районы, улицы, здания Москвы
• Сервисы - генерация фактов, постов, изображений
• Контроль качества - проверка соответствия требованиям

📋 Этапы работы согласно инструкции

Этап 1: Подготовка и планирование

• ✅ База объектов (районы, улицы, дома)
• ✅ Критерии отбора (минимум 3 факта)
• ✅ Приоритеты (уникальные истории, легенды, факты с датами)

Этап 2: Сбор информации

• ✅ Perplexity AI для сбора фактов
• ✅ Фильтрация данных (конкретные факты с датами)
• ✅ Проверка минимального количества фактов

Этап 3: Создание текста

• ✅ GPT для генерации финального текста
• ✅ Соблюдение лимитов (900-1000 символов)
• ✅ Структура: крючок → факты → финал

Этап 4: Подготовка изображения

• ✅ Гербы для районов
• ✅ Архитектурные иллюстрации для улиц/домов
• ✅ Стили: Sempé + pastel illustration

Этап 5: Контроль качества

• ✅ Проверка длины текста
• ✅ Проверка количества фактов
• ✅ Проверка уникальности
• ✅ Отсутствие эмодзи и ссылок

🚀 Быстрый старт

1. Клонирование проекта:

git clone https://github.com/semen243/MoscowHistoryMCP.git
cd MoscowHistoryMCP

2. Настройка API ключей:

Создайте файл .env:

OPENAI_API_KEY=your_openai_api_key_here
PERPLEXITY_API_KEY=your_perplexity_api_key_here
IMAGE_PROCESSING_API_KEY=5fb1c9714b1e8d89852629d86765cd50
MIN_FACTS_REQUIRED=3
MAX_POSTS_PER_DAY=30
MCP_SERVER_HOST=0.0.0.0
MCP_SERVER_PORT=8000

3. Запуск через Docker:

docker-compose up -d --build

4. Проверка работы:

curl http://localhost:8000/info

📡 API Эндпоинты

Базовый URL: http://localhost:8000

1. GET /info - Информация о сервере

curl http://localhost:8000/info

2. GET /objects - Список объектов

curl http://localhost:8000/objects

3. POST /facts - Сбор фактов для объекта

curl -X POST http://localhost:8000/facts \
  -H "Content-Type: application/json" \
  -d '{"object_type": "street", "object_name": "Арбат"}'

4. POST /generate - Полная генерация поста

curl -X POST http://localhost:8000/generate \
  -H "Content-Type: application/json" \
  -d '{"object_type": "street", "object_id": "arbat_street"}'

5. GET /workflow - Ежедневный рабочий процесс

curl http://localhost:8000/workflow

6. POST /image/process - Обработка изображения

curl -X POST http://localhost:8000/image/process \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/image.jpg", "object_name": "Арбат", "object_type": "street"}'

7. GET /image/status - Статус задачи обработки изображения

curl "http://localhost:8000/image/status?task_id=task_12345678"

8. GET /image/test - Тест API обработки изображений

curl http://localhost:8000/image/test

🧪 Примеры использования

Генерация поста о районе:

curl -X POST http://localhost:8000/generate \
  -H "Content-Type: application/json" \
  -d '{"object_type": "district", "object_id": "district_1"}'

Генерация поста об улице:

curl -X POST http://localhost:8000/generate \
  -H "Content-Type: application/json" \
  -d '{"object_type": "street", "object_id": "arbat_street"}'

Генерация поста о здании:

curl -X POST http://localhost:8000/generate \
  -H "Content-Type: application/json" \
  -d '{"object_type": "building", "object_id": "building_1"}'

📊 Структура ответа

Успешная генерация поста:

{
  "success": true,
  "object": {
    "type": "street",
    "id": "arbat_street",
    "name": "Улица Арбат"
  },
  "post": {
    "text": "Улица Арбат - одна из самых известных улиц Москвы...",
    "character_count": 950,
    "ready_for_publication": true
  },
  "facts": {
    "used": 5,
    "source": "perplexity",
    "list": ["Факт 1", "Факт 2", "..."]
  },
  "image": {
    "success": true,
    "image_type": "architectural_illustration",
    "style": "архитектурная акварель в духе Jean-Jacques Sempé",
    "nano_banano_prompt": "Сделай фото рисованным..."
  },
  "quality_control": {
    "passed": true,
    "checks": {
      "text_length": true,
      "facts_count": true,
      "uniqueness": true,
      "no_emojis": true,
      "no_links": true
    },
    "ready_for_publication": true
  },
  "generated_at": "2024-01-15T10:30:00"
}

🗓️ Ежедневный рабочий процесс

Сервер автоматически:

1. Выбирает район дня
2. Генерирует пост о районе
3. Выбирает улицы из этого района
4. Генерирует посты об улицах
5. Переходит к домам при необходимости

Получение плана на день:

curl http://localhost:8000/workflow

🖼️ Обработка изображений

Тестирование API:

curl http://localhost:8000/image/test

Обработка изображения:

curl -X POST http://localhost:8000/image/process \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg",
    "object_name": "Улица Арбат",
    "object_type": "street"
  }'

Проверка статуса обработки:

curl "http://localhost:8000/image/status?task_id=your_task_id"

Особенности обработки:

• Размер изображения: 1:1 (квадратное)
• Формат: PNG
• Стили:

- "архитектурная акварель в духе Jean-Jacques Sempé" - "Sempé + pastel illustration"

• Для районов: Официальные гербы
• Для улиц/домов: Архитектурные иллюстрации

🔧 Конфигурация

config/mcp_config.yaml:

server:
  name: "moscow-history-pipeline"
  version: "1.0.0"
  description: "MCP сервер для генерации исторического контента о Москве"
  port: 8000

content:
  daily_posts: 30
  min_facts_required: 3
  text_limits:
    min_chars: 900
    max_chars: 1000
  
  priorities:
    - "Уникальные и малоизвестные истории"
    - "Интересные истории, легенды, байки"
    - "Исторические факты с датами"
    - "Связь с известными личностями"
    - "Архитектурные особенности"
  
  image_styles:
    - "архитектурная акварель в духе Jean-Jacques Sempé"
    - "Sempé + pastel illustration"

🛠️ Развертывание на сервере

1. Подготовка сервера:

apt update && apt upgrade -y
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
apt install docker-compose -y

2. Развертывание:

mkdir -p /opt/moscow-history-mcp
cd /opt/moscow-history-mcp
git clone https://github.com/semen243/MoscowHistoryMCP.git .

# Создание .env файла
cat > .env << 'EOF'
MIN_FACTS_REQUIRED=3
MAX_POSTS_PER_DAY=30
MCP_SERVER_HOST=0.0.0.0
MCP_SERVER_PORT=8000
OPENAI_API_KEY=your_openai_api_key_here
PERPLEXITY_API_KEY=your_perplexity_api_key_here
EOF

# Запуск
docker-compose up -d --build

3. Проверка:

curl http://localhost:8000/info

🔧 Управление сервисом

Проверка статуса:

docker-compose ps
docker-compose logs --tail=50

Перезапуск:

docker-compose restart

Обновление:

git pull
docker-compose up -d --build

🚨 Устранение неполадок

Сервер не запускается:

1. Проверьте логи: docker-compose logs
2. Проверьте .env файл
3. Проверьте API ключи

API не отвечает:

1. Проверьте статус: docker-compose ps
2. Проверьте порт: netstat -tlnp | grep 8000

Ошибки генерации:

1. Проверьте API ключи Perplexity и OpenAI
2. Проверьте доступность интернета
3. Проверьте логи сервера

📊 Мониторинг

Логи:

docker-compose logs -f

Статистика:

curl http://localhost:8000/info

🔐 Безопасность

Рекомендации:

1. Используйте HTTPS для внешних подключений
2. Ограничьте доступ через файрвол
3. Регулярно обновляйте зависимости
4. Мониторьте логи

Файрвол:

ufw allow 8000
ufw allow 22
ufw enable

📞 Поддержка

• GitHub: https://github.com/semen243/MoscowHistoryMCP
• Документация: См. README.md

🎯 Заключение

Moscow History MCP Server - это полнофункциональный сервер, который следует детальной инструкции по созданию качественного контента об истории Москвы. Сервер автоматизирует весь процесс от сбора фактов до контроля качества, обеспечивая высокое качество генерируемых постов.