# Volody2006 Mcp Server

> MCP server from Volody2006/mcp-server.

- **Type:** MCP server
- **Install:** `agentstack add mcp-volody2006-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Volody2006](https://agentstack.voostack.com/s/volody2006)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Volody2006](https://github.com/Volody2006)
- **Source:** https://github.com/Volody2006/mcp-server

## Install

```sh
agentstack add mcp-volody2006-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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

2. **Установите зависимости**:
   ```bash
   uv sync
   ```

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

4. **Запустите серверы**:
   ```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:

```bash
# Скопировать все файлы конфигурации
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)** - Максимальная безопасность

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

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

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

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

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

- **[Основная документация](python_mcp_servers_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/`:

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

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

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

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

```bash
# Запустить все тесты
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 на тест
- **Зависимости**: Использовать реальные зависимости при возможности

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

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

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

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

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

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

```bash
# Использовать ограниченную конфигурацию
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 развертывание

```bash
# Собрать 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
   ```
3. **Установите зависимости**:
   ```bash
   uv sync
   ```
4. **Запустите тесты**:
   ```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/](https://www.perplexity.ai/)
  - **Альтернатива**: Tavily MCP Server (уже реализован)

- [ ] **firecrawl-mcp** (Web scraping) - 📋 Planned ⚠️
  - **Назначение**: Веб-скрейпинг и извлечение данных
  - **Статус**: Коммерческий сервис
  - **Ссылка**: [https://www.firecrawl.dev/](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)

## 📞 Поддержка

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

- **[Документация](python_mcp_servers_documentation.md)** - Комплексные руководства
- **[FAQ](SUPPORT.md)** - Часто задаваемые вопросы и ответы
- **[Issues](https://github.com/your-username/mcp-servers/issues)** - Сообщения об ошибках и запросы функций
- **[Discussions](https://github.com/your-username/mcp-servers/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](https://github.com/modelcontextprotocol/sdk)** - Официальный MCP SDK
- **[uv](https://github.com/astral-sh/uv)** - Python пакетный менеджер
- **[ruff](https://github.com/astral-sh/ruff)** - Python линтер и форматтер
- **[pytest](https://github.com/pytest-dev/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](https://github.com/Volody2006)
- **Source:** [Volody2006/mcp-server](https://github.com/Volody2006/mcp-server)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-volody2006-mcp-server
- Seller: https://agentstack.voostack.com/s/volody2006
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.