Volody2006 Mcp Server

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

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

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

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

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

Установка

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

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

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

``bash uv sync ``

1. Настройте Cline:

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

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

```bash # Запустить все серверы по умолчанию 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/

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

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

• [Безопасная конфигурация](rules/examples/safe_config.json) - Сбалансированная безопасность и функциональность
• [Ограниченная конфигурация](rules/examples/restricted_config.json) - Максимальная безопасность

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

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

# 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"

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

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

• [Основная документация](pythonmcpservers_documentation.md) - Комплексное руководство
• [Руководство по безопасности](SECURITY.md) - Лучшие практики безопасности
• [Руководство по использованию](rules/usage_guidelines.md) - Как использовать MCP серверы
• [Лучшие практики](rules/best_practices.md) - Развитие и эксплуатационные практики

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

• [Python серверы](python/README.md) - Инструменты Python разработки
• [DevOps серверы](devops/README.md) - Управление инфраструктурой
• [Серверы баз данных](database/README.md) - Управление базами данных
• [Серверы продуктивности](productivity/README.md) - Повышение продуктивности

MCP Правила

• [Правила безопасности](.clinerules/01-security-rules.md) - Требования безопасности
• [Руководство по разработке](.clinerules/02-mcp-development.md) - Практики разработки
• [Требования к тестированию](.clinerules/03-testing-requirements.md) - Руководство по тестированию
• [Управление зависимостями](.clinerules/04-dependency-management.md) - Практики управления зависимостями
• [Правила конфигурации](.clinerules/05-server-configuration.md) - Руководство по конфигурации
• [Руководство по развертыванию](.clinerules/06-deployment-guidelines.md) - Практики развертывания

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

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

• Валидация ввода для всех параметров
• Ограничение ресурсов (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. Склонируйте свой форк:

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

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

``bash uv sync ``

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

``bash pytest ``

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

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

Процесс Pull Request

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

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

Phase 1: Core Development Servers ✅

• [x] uv-mcp (Package management)
• [x] ruff-mcp (Code quality)
• [x] pytest-mcp (Testing)
• [x] docker-mcp (Container management)
• [x] 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)

📞 Поддержка

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

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

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

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

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

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

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

📄 Лицензия

Этот проект лицензирован по MIT License - см. файл [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](CHANGELOG.md) для последних обновлений и [CONTRIBUTING.md](CONTRIBUTING.md) для руководства по вкладу.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Volody2006
• Source: Volody2006/mcp-server
• License: MIT

Install and usage instructions live in the source repository linked above.