MCP Серверы для Python разработки

Комплексная коллекция серверов Model Context Protocol (MCP) для Python разработки, DevOps, управления базами данных и повышения продуктивности.

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

Предварительные требования

• Python 3.12+ (см. .python-version)
• uv пакетный менеджер
• MCP SDK для Python

Установка

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

   git clone https://github.com/your-username/mcp-servers.git
   cd mcp-servers

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

   uv sync

3. Настройте Cline: Скопируйте файлы конфигурации из cline_config/ в вашу директорию конфигурации Cline.

4. Запустите серверы:

   # Запустить все серверы по умолчанию
   python main.py
   
   # Запустить конкретные серверы
   python main.py uv-mcp ruff-mcp
   
   # Запустить все серверы
   python main.py all

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

mcp-servers/
├── python/                    # Python development servers
│   ├── uv-mcp/              # Package management
│   ├── ruff-mcp/            # Code linting and formatting
│   ├── pytest-mcp/          # Testing framework
│   └── vscode-mcp/          # VS Code integration
├── devops/                    # DevOps and infrastructure
│   └── docker-mcp/          # Docker container management
├── database/                  # Database management
│   └── prisma-postgres-mcp/ # PostgreSQL with Prisma
├── productivity/              # Productivity tools
│   ├── context7-mcp/        # Documentation access
│   └── e2b-mcp/             # Secure code execution
├── rules/                     # Guidelines and examples
├── cline_config/              # Cline integration
├── .clinerules/               # MCP-specific rules
├── main.py                    # Server launcher
└── README.md                  # This file

🛠️ Доступные серверы

Python Development

Server	Purpose	Status
uv-mcp	Python package management	✅ Implemented
ruff-mcp	Code linting and formatting	✅ Implemented
pytest-mcp	Testing framework	✅ Implemented
vscode-mcp	VS Code integration	✅ Implemented

DevOps & Infrastructure

Server	Purpose	Status
docker-mcp	Docker container management	✅ Implemented
kubernetes-mcp	Kubernetes cluster management	🚧 Planned
terraform-mcp	Infrastructure as Code	🚧 Planned

Database Management

Server	Purpose	Status
prisma-postgres-mcp	PostgreSQL with Prisma ORM	🚧 Planned
mongodb-mcp	MongoDB database management	🚧 Planned
redis-mcp	Redis cache management	🚧 Planned

Productivity Tools

Server	Purpose	Status
context7-mcp	Documentation access	🚧 Planned
e2b-mcp	Secure code execution	🚧 Planned
playwright-mcp	Browser automation	🚧 Planned

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

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

Скопируйте файлы конфигурации из cline_config/ в вашу директорию конфигурации Cline:

# Скопировать все файлы конфигурации
cp -r cline_config/* ~/.config/cline/

# Или скопировать конкретные файлы
cp cline_config/claude_desktop_config.json ~/.config/cline/
cp cline_config/claude_desktop_rules.json ~/.config/cline/

Безопасная конфигурация

Выберите конфигурацию безопасности, которая соответствует вашим потребностям:

• Безопасная конфигурация - Сбалансированная безопасность и функциональность
• Ограниченная конфигурация - Максимальная безопасность

Переменные окружения

Установите необходимые переменные окружения для каждого сервера:

# Python серверы
export UV_PROJECT_PATH="/path/to/python/project"
export RUFF_CONFIG_FILE="pyproject.toml"

# Серверы баз данных
export DATABASE_URL="postgresql://user:password@localhost:5432/db"

# Серверы продуктивности
export CONTEXT7_API_KEY="your-api-key"
export E2B_API_KEY="your-api-key"

📚 Документация

Начало работы

• Основная документация - Комплексное руководство
• Руководство по безопасности - Лучшие практики безопасности
• Руководство по использованию - Как использовать MCP серверы
• Лучшие практики - Развитие и эксплуатационные практики

Документация по конкретным серверам

• Python серверы - Инструменты Python разработки
• DevOps серверы - Управление инфраструктурой
• Серверы баз данных - Управление базами данных
• Серверы продуктивности - Повышение продуктивности

MCP Правила

• Правила безопасности - Требования безопасности
• Руководство по разработке - Практики разработки
• Требования к тестированию - Руководство по тестированию
• Управление зависимостями - Практики управления зависимостями
• Правила конфигурации - Руководство по конфигурации
• Руководство по развертыванию - Практики развертывания

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

Функции безопасности

• Валидация ввода для всех параметров
• Ограничение ресурсов (CPU, память, время)
• Контроль доступа к файловой системе
• Ограничение сетевого доступа
• Аудит логирования для всех операций
• Рабочие процессы утверждения для опасных операций

Правила безопасности

Все серверы следуют строгим правилам безопасности:

1. Режим только для чтения по умолчанию
2. Валидация ввода для всех операций
3. Ограничение ресурсов для предотвращения злоупотреблений
4. Контроль доступа к чувствительным операциям
5. Логирование и мониторинг для событий безопасности

Конфигурация безопасности

Используйте примеры конфигурации безопасности в rules/examples/:

# Для разработки (сбалансированная безопасность)
cp rules/examples/safe_config.json cline_config/claude_desktop_rules.json

# Для продакшена (максимальная безопасность)
cp rules/examples/restricted_config.json cline_config/claude_desktop_rules.json

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

Запуск тестов

# Запустить все тесты
pytest

# Запустить тесты с покрытием
pytest --cov=python --cov-report=xml

# Запустить тесты конкретного сервера
pytest python/uv-mcp/test_uv_mcp.py

# Запустить тесты безопасности
pytest --security

Требования к тестам

• Покрытие: Минимум 80% для бизнес-логики
• Типы тестов: Unit, интеграционные и MCP-специфичные тесты
• Структура тестов: Паттерн AAA (Arrange-Act-Assert)
• Максимум Asserts: 5 на тест
• Зависимости: Использовать реальные зависимости при возможности

🚀 Развертывание

Среда разработки

# Установить зависимости
uv sync

# Запустить серверы
python main.py

# Мониторить логи
tail -f logs/mcp-servers.log

Продакшн среда

# Использовать ограниченную конфигурацию
cp rules/examples/restricted_config.json cline_config/claude_desktop_rules.json

# Запустить с продакшн настройками
python main.py --production

# Мониторить с systemd
sudo systemctl enable mcp-servers
sudo systemctl start mcp-servers

Docker развертывание

# Собрать Docker образ
docker build -t mcp-servers:latest .

# Запустить контейнер
docker run -d --name mcp-servers mcp-servers:latest

# Просмотреть логи
docker logs mcp-servers

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

Настройка разработки

1. Форкните репозиторий
2. Склонируйте свой форк:

   git clone https://github.com/your-username/mcp-servers.git
   cd mcp-servers

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

   uv sync

4. Запустите тесты:

   pytest

Руководство по вкладу

• Следуйте существующему стилю кода и соглашениям
• Добавляйте тесты для новой функциональности
• Обновляйте документацию при любых изменениях
• Убедитесь, что все тесты проходят перед отправкой
• Будьте уважительны и конструктивны во всех взаимодействиях

Процесс Pull Request

1. Создайте ветку от main
2. Внесите изменения следуя руководствам
3. Добавьте тесты и документацию
4. Запустите тесты для проверки работоспособности
5. Создайте pull request с понятным описанием

📈 Дорожная карта

Phase 1: Core Development Servers ✅

• uv-mcp (Package management)
• ruff-mcp (Code quality)
• pytest-mcp (Testing)
• docker-mcp (Container management)
• vscode-mcp (Editor integration)

Phase 2: Database & DevOps 🚧

• prisma-postgres-mcp (Database management)
• context7-mcp (Documentation access)
• e2b-mcp (Secure execution)
• Update Cline configuration
• Test all servers

Phase 3: Productivity Tools 📋

Бесплатные решения (приоритет)

• playwright-mcp (Browser automation) - 📋 Planned
  • Назначение: Браузерная автоматизация и веб-скрейпинг
  • Тип: Бесплатное решение (Playwright - open-source)

Коммерческие решения (на рассмотрении пользователя) ⚠️

• perplexity-mcp (AI search) - 📋 Planned ⚠️

  • Назначение: AI поиск и исследование
  • Статус: Коммерческий сервис
  • Ссылка: https://www.perplexity.ai/
  • Альтернатива: Tavily MCP Server (уже реализован)

• firecrawl-mcp (Web scraping) - 📋 Planned ⚠️

  • Назначение: Веб-скрейпинг и извлечение данных
  • Статус: Коммерческий сервис
  • Ссылка: https://www.firecrawl.dev/
  • Альтернатива: HTTP запросы + BeautifulSoup

Phase 4: Testing & Research 📋

Бесплатные решения (приоритет)

• Additional testing tools - 📋 Planned

  • Назначение: Профилирование, нагрузочное тестирование, специализированные тесты
  • Тип: Бесплатное решение (pytest, coverage, profiling)

• Research and analysis tools - 📋 Planned

  • Назначение: Инструменты для анализа кода и данных
  • Тип: Бесплатное решение (pandas, numpy, matplotlib)

• Performance optimization - 📋 Planned

  • Назначение: Инструменты для оптимизации производительности
  • Тип: Бесплатное решение (cProfile, memory_profiler)

📞 Поддержка

Получение помощи

• Документация - Комплексные руководства
• FAQ - Часто задаваемые вопросы и ответы
• Issues - Сообщения об ошибках и запросы функций
• Discussions - Обсуждения сообщества

Сообщение об ошибках

При сообщении об ошибках, пожалуйста, включайте:

1. Четкое описание проблемы
2. Шаги для воспроизведения проблемы
3. Ожидаемое vs фактическое поведение
4. Детали окружения (версия Python, MCP SDK, ОС)
5. Сообщения об ошибках и логи
6. Скриншоты (если применимо)

Проблемы безопасности

Для уязвимостей безопасности, пожалуйста, следуйте процессу в SECURITY.md.

📄 Лицензия

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

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

• Tavily AI - За предоставление возможностей веб-поиска во время разработки
• Model Context Protocol (MCP) - За спецификацию MCP и SDK
• Open Source Community - За отзывы, вклад и поддержку

📊 Статистика

• Языки: Python, TypeScript, JavaScript
• Серверы: 8+ реализовано, 15+ запланировано
• Тесты: Комплексное тестирование
• Документация: Обширная документация и примеры
• Безопасность: Функции безопасности корпоративного уровня

🔗 Связанные проекты

• MCP SDK - Официальный MCP SDK
• uv - Python пакетный менеджер
• ruff - Python линтер и форматтер
• pytest - Python фреймворк для тестирования

---

Примечание: Этот проект активно разрабатывается и поддерживается. Проверяйте CHANGELOG.md для последних обновлений и CONTRIBUTING.md для руководства по вкладу.