🔧 MCP Server Collection

Коллекция простых и мощных MCP (Model Context Protocol) серверов для различных задач. Большинство серверов работают полностью бесплатно без API ключей! 🎉

🎯 Доступные серверы

Сервер	Порт	Описание	API	Статус
🌤️ Weather	8001	Погода и прогнозы	Open-Meteo	🆓 Бесплатно
🔍 Search	8002	Веб-поиск, новости, изображения	DuckDuckGo	🆓 Бесплатно
🌐 IP Info	8003	Информация об IP-адресах	Бесплатные API	🆓 Бесплатно
🏛️ Artifact Registry	8004	Cloud.ru реестр артефактов	Cloud.ru	🔑 Требует ключи
🥊 UFC	8005	UFC и MMA информация	UFC API	🆓 Бесплатно
📚 Wikipedia	8006	Поиск в Wikipedia	Wikipedia API	🆓 Бесплатно
🔍 Yandex Search	8007	Поиск Yandex	Yandex API	🔑 Требует ключи
📥 Fetch	8008	HTTP запросы и загрузка	-	🆓 Бесплатно

⚡ Быстрый старт

Установка и запуск всех бесплатных серверов:

# Клонируйте репозиторий
git clone https://github.com/your-username/simple_mcp_server.git
cd simple_mcp_server

# Запустите все бесплатные серверы одной командой
make start-all

# Проверьте статус
make ports

Отдельный запуск сервера:

# Например, Weather сервер
cd mcp-weather
uv sync
uv run python server.py

Docker запуск:

# Запуск конкретного сервера
make weather-run-build

# Или используйте docker-compose в папке сервера
cd mcp-weather
docker-compose up -d

🌤️ Weather Server - Погода

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

• 🌍 Актуальная погода для любого города мира
• 📅 Прогноз погоды на неделю
• 🔄 Реальные данные без API ключей (Open-Meteo)
• 🌐 Поддержка международных названий городов

cd mcp-weather && uv run python server.py
# Доступен на http://localhost:8001

🔍 Search Server - Веб-поиск

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

• 🌐 Веб-поиск (до 50 результатов)
• 📰 Поиск новостей с датами
• 🖼️ Поиск изображений с размерами
• 🎥 Поиск видео с длительностью
• 🌍 Региональные настройки
• ⏰ Фильтры по времени

cd mcp-search && uv run python server.py
# Доступен на http://localhost:8002

🌐 IP Server - IP информация

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

• 🌍 Геолокация IP-адресов
• 🎯 Детальная информация (провайдер, часовой пояс)
• 🤖 Автоопределение IP пользователя
• 🔄 Поддержка IPv4 и IPv6
• 🛡️ Автоматический fallback между API

cd mcp-ip && uv run python server.py
# Доступен на http://localhost:8003

📚 Wikipedia Server - Поиск в Wikipedia

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

• 🔍 Поиск статей по ключевым словам
• 📖 Краткое и полное содержание статей
• 🏗️ Структура разделов статьи
• 🔗 Извлечение ссылок из статей
• 🌐 Поддержка 5 языков (ru, en, de, fr, es)

cd mcp-wikipedia && uv run python server.py
# Доступен на http://localhost:8006

🥊 UFC Server - UFC & MMA

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

• 🥊 Информация о бойцах и статистика
• 📅 Расписание турниров
• 🏆 Официальные рейтинги
• 📊 Результаты боев
• 👑 История чемпионских боев

cd mcp-ufc && uv run python server.py
# Доступен на http://localhost:8005

🏛️ Artifact Registry Server - Cloud.ru

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

• 📦 Управление реестрами Docker/Debian/RPM
• ⚙️ Мониторинг операций
• 🛡️ Управление безопасностью
• 🔍 Детальная информация о реестрах

Требует настройки:

export CLOUD_RU_KEY_ID="your_key_id_here"
export CLOUD_RU_SECRET="your_secret_here"
cd mcp-artifact-registry && uv run python server.py

🔍 Yandex Search Server

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

• 🌐 Поиск через Yandex Search API
• 📊 Структурированные результаты
• 🔧 Гибкие настройки поиска

Требует API ключ Yandex

📥 Fetch Server - HTTP клиент

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

• 🌐 HTTP GET/POST запросы
• 📥 Загрузка файлов и контента
• 🔧 Настраиваемые заголовки
• ⚡ Асинхронные запросы

cd mcp-fetch && uv run python server.py
# Доступен на http://localhost:8008

🛠️ Технологии

• FastMCP 2.0 - MCP фреймворк для Python
• Python 3.11+ - современная версия Python
• uv - быстрое управление зависимостями
• pytest - комплексное тестирование
• Docker - контейнеризация
• httpx - асинхронный HTTP клиент

📊 Статистика проекта

• 8 серверов в коллекции
• 6 бесплатных серверов (не требуют API ключей)
• 35+ инструментов доступно
• 120+ тестов с полным покрытием
• Docker support для всех серверов
• Makefile команды для удобства

🐳 Docker команды

# Управление всеми сервисами
make start-all      # Запустить все бесплатные серверы
make stop-all       # Остановить все серверы
make ports          # Показать используемые порты
make list-services  # Список всех сервисов

# Команды для отдельных серверов
make weather-run-build    # Weather сервер
make search-run-build     # Search сервер
make ip-run-build         # IP сервер
make ufc-run-build        # UFC сервер
make wikipedia-run-build  # Wikipedia сервер
# ... и т.д.

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

Каждый сервер включает полный набор тестов:

# Тестирование конкретного сервера
cd mcp-weather
make test-all       # Все тесты
make test-unit      # Unit тесты
make test-integration # Интеграционные тесты
make test-cov       # Тесты с покрытием

# Демонстрационные тесты
make test-demo      # Показать работу всех функций

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

simple_mcp_server/
├── LICENSE                    # MIT лицензия
├── README.md                  # Этот файл
├── Makefile                   # Команды управления
├── mcp-weather/              # 🌤️ Weather сервер
├── mcp-search/               # 🔍 Search сервер
├── mcp-ip/                   # 🌐 IP информация
├── mcp-artifact-registry/    # 🏛️ Cloud.ru Artifact Registry
├── mcp-ufc/                  # 🥊 UFC информация
├── mcp-wikipedia/            # 📚 Wikipedia поиск
├── mcp-yandex-search/        # 🔍 Yandex поиск
└── mcp-fetch/                # 📥 HTTP клиент

Каждая папка содержит:

• server.py - основной сервер
• README.md - детальная документация
• pyproject.toml - зависимости
• Dockerfile - Docker конфигурация
• test/ - тесты
• Makefile - команды разработки

🤝 Вклад в проект

Мы приветствуем любые улучшения!

1. Fork проект
2. Создайте feature branch (git checkout -b feature/AmazingFeature)
3. Commit изменения (git commit -m 'Add some AmazingFeature')
4. Push в branch (git push origin feature/AmazingFeature)
5. Откройте Pull Request

Идеи для вклада:

• 🆕 Новые MCP серверы
• 🐛 Исправление багов
• 📚 Улучшение документации
• 🧪 Добавление тестов
• 🌐 Локализация
• ⚡ Оптимизация производительности

📄 Лицензия

Этот проект лицензирован под MIT License - см. файл LICENSE для деталей.

🎉 Благодарности

• FastMCP - отличный MCP фреймворк
• Open-Meteo - бесплатное API погоды
• DuckDuckGo - приватный поиск
• Все контрибьюторы проекта!

---

⭐ Понравился проект? Поставьте звездочку! ⭐