Personal Assistant MCP Server 🤖

Демонстрационный MCP (Model Context Protocol) сервер, который показывает все возможности протокола через практические инструменты персонального помощника.

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

📋 Tools (Инструменты)

• add_task - Добавление новых задач с приоритетами
• get_tasks - Просмотр списка задач с фильтрацией
• complete_task - Отметка задач как выполненных
• calculate - Калькулятор с сохранением истории
• generate_password - Генератор безопасных паролей
• text_stats - Анализ текста (статистика слов, символов и т.д.)

📦 Resources (Ресурсы)

• tasks://list - JSON список всех задач
• calculator://history - История всех вычислений

💡 Prompts (Промпты)

• task_summary - Умная сводка по задачам для ИИ
• productivity_tips - Советы по продуктивности с разными фокусами

🛠️ Установка и запуск

1. Установка зависимостей

pip install -r requirements.txt

2. Варианты запуска

FastMCP сервер (рекомендуется)

python personal_assistant.py

Стандартный MCP сервер

python standard_mcp_server.py

Демонстрационные тесты

python demo_test.py

Тестирование MCP протокола

python test_mcp_direct.py

Интеграция с OpenRouter

# Создайте файл .env на основе env_example.txt
python openrouter_client.py

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

Управление задачами

# Добавить задачу
add_task("Написать отчет", "Подготовить квартальный отчет", "high")

# Посмотреть задачи
get_tasks("pending")  # только невыполненные
get_tasks("all")      # все задачи

# Завершить задачу
complete_task(1)

Калькулятор

calculate("2 + 2 * 3")
calculate("(10 + 5) / 3")

Генератор паролей

generate_password(16, True)   # длинный пароль с символами
generate_password(8, False)   # короткий без символов

Анализ текста

text_stats("Это пример текста для анализа. Текст содержит разные слова.")

🔧 Архитектура

Варианты серверов

• personal_assistant.py - FastMCP сервер (упрощенная реализация)
• standard_mcp_server.py - Полноценный MCP сервер по стандарту
• openrouter_client.py - Клиент для интеграции с OpenRouter API

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

• demo_test.py - Демонстрация всех функций с примерами
• test_mcp_direct.py - Прямое тестирование MCP протокола

Хранение данных

• Использует хранение в памяти (для демонстрации)
• В реальном проекте можно заменить на базу данных

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

• Калькулятор использует безопасное вычисление выражений
• Валидация входных данных для всех инструментов

Типизация

• Полная типизация с использованием typing
• Документированные функции с описанием параметров

🌟 Особенности реализации

1. Красивый вывод - использование эмодзи и форматирование
2. Обработка ошибок - валидация входных данных
3. История операций - сохранение результатов вычислений
4. Фильтрация данных - различные способы просмотра задач
5. Умные промпты - контекстные подсказки для ИИ

🔄 Интеграция с ИИ

Этот MCP сервер может интегрироваться с любыми ИИ помощниками, поддерживающими MCP протокол:

• Claude Desktop
• ChatGPT с MCP плагинами
• Другие MCP-совместимые приложения

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

example/
├── personal_assistant.py     # Основной MCP сервер (FastMCP)
├── standard_mcp_server.py    # Стандартный MCP сервер
├── openrouter_client.py      # Клиент для OpenRouter API
├── demo_test.py             # Демонстрационные тесты функций
├── test_mcp_direct.py       # Прямые тесты MCP протокола
├── requirements.txt         # Зависимости Python
├── README.md               # Документация
├── env_example.txt         # Пример переменных окружения
└── .gitignore              # Git ignore файл

🎯 Цель проекта

Демонстрация всех возможностей MCP протокола:

• ✅ Tools - выполнение действий
• ✅ Resources - доступ к данным
• ✅ Prompts - контекстные подсказки

🤝 Развитие проекта

Этот проект можно расширить:

• Добавить персистентное хранение (SQLite, PostgreSQL)
• Интегрировать внешние API (погода, новости)
• Добавить веб-интерфейс
• Реализовать систему пользователей
• Добавить больше инструментов анализа