# Damens Mcps

> A collection of MCP servers I've put together with various AI tools for infrastructure management

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

## Install

```sh
agentstack add mcp-filthyrake-damens-mcps
```

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

## About

# Damen's MCP Servers Collection 🚀

[](https://opensource.org/licenses/MIT)
[](https://github.com/filthyrake/damens_mcps/issues)
[](https://github.com/filthyrake/damens_mcps/stargazers)
[](https://github.com/filthyrake/damens_mcps/actions/workflows/test.yml)
[](https://github.com/filthyrake/damens_mcps/actions/workflows/code-quality.yml)
[](https://codecov.io/gh/filthyrake/damens_mcps)
[](https://github.com/psf/black)
[](https://pycqa.github.io/isort/)
[](https://github.com/PyCQA/bandit)
[](https://github.com/pre-commit/pre-commit)

> **Note:** These MCP servers were generated using [Cursor](https://cursor.sh/) AI tools. While functional, they may benefit from human review and refinement for production use.

A comprehensive collection of Model Context Protocol (MCP) servers for managing various infrastructure components. These servers enable AI assistants to directly interact with and manage your infrastructure through standardized MCP interfaces.

## 📋 Project Overview

This repository contains MCP servers for the following platforms:

| Project | Status | Description |
|---------|--------|-------------|
| [**pfSense MCP**](./pfsense-mcp/) | ✅ **Production Ready** | Firewall and network management for pfSense |
| [**TrueNAS MCP**](./truenas-mcp/) | ✅ **Production Ready** | Storage and NAS management for TrueNAS |
| [**iDRAC MCP**](./idrac-mcp/) | ✅ **Production Ready** | Dell PowerEdge server management via iDRAC |
| [**Proxmox MCP**](./proxmox-mcp/) | ✅ **Production Ready** | Virtualization platform management for Proxmox VE |

## 🚀 Quick Start

### Prerequisites

- **Python 3.8+** for all projects
- **Docker** (optional, for containerized deployment)
- **Network access** to your target systems
- **API credentials** for each platform

### Installation & Setup

1. **Clone the repository:**
   ```bash
   git clone 
   cd damens_mcps
   ```

2. **Choose your project** and navigate to it:
   ```bash
   cd pfsense-mcp    # For pfSense management
   cd truenas-mcp    # For TrueNAS management
   cd idrac-mcp      # For Dell server management (production ready)
   cd proxmox-mcp    # For Proxmox management (production ready)
   ```

3. **Set up virtual environment:**
   ```bash
   python3 -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   pip install -r requirements.txt
   ```

4. **Configure environment:**
   ```bash
   cp env.example .env
   # Edit .env with your system credentials
   ```

5. **Start the server:**
   ```bash
   # Method varies by project - check individual READMEs
   python -m src.http_server
   # or
   python -m src.cli serve
   ```

## 🔧 Configuration

### Environment Variables

Each project uses environment variables for configuration. Copy the `env.example` file to `.env` and update with your settings:

```bash
# Example for pfSense
PFSENSE_HOST=192.168.1.1
PFSENSE_USERNAME=admin
PFSENSE_PASSWORD=your-password
PFSENSE_API_KEY=your-api-key

# Example for TrueNAS
TRUENAS_HOST=192.168.1.100
TRUENAS_API_KEY=your-api-key
TRUENAS_USERNAME=admin
TRUENAS_PASSWORD=your-password
```

### Security Notes

⚠️ **Important Security Considerations:**

- **Change default passwords** in production
- **Use API keys** instead of passwords when possible
- **Update IP addresses** from example values
- **Use HTTPS** for all connections
- **Restrict network access** to MCP servers

## 🐳 Docker Deployment

Docker deployment is available for **TrueNAS MCP** and **Proxmox MCP** projects:

```bash
# Navigate to project with Docker support
cd truenas-mcp  # or proxmox-mcp

# Build and run with Docker Compose
docker-compose -f docker/docker-compose.yml up -d

# Or build manually
docker build -f docker/Dockerfile -t mcp-server .
docker run -p 8000:8000 --env-file .env mcp-server
```

**Docker Support by Project:**

| Project | Docker Support | K8s Support |
|---------|----------------|-------------|
| TrueNAS MCP | ✅ Yes | ✅ Yes |
| Proxmox MCP | ✅ Yes | ✅ Yes |
| pfSense MCP | ❌ No | ❌ No |
| iDRAC MCP | ❌ No | ❌ No |

> **Note:** pfSense and iDRAC projects are designed for direct Python execution due to their specific deployment requirements and are not currently containerized.

## ☸️ Kubernetes Deployment

Kubernetes manifests are provided for **TrueNAS MCP** and **Proxmox MCP**:

```bash
# Navigate to project with K8s support
cd truenas-mcp  # or proxmox-mcp

# Deploy to Kubernetes
kubectl apply -f k8s/

# Check deployment status
kubectl get pods -l app=mcp-server
```

## 📊 Monitoring & Health Checks

Each server provides health check endpoints:

```bash
# Check server health
curl http://localhost:8000/health

# Get server status
curl http://localhost:8000/status
```

## 🔍 Testing

### Test Coverage Status

All projects now have comprehensive test infrastructure with CI/CD automation:

| Project | Tests | Coverage | Status |
|---------|-------|----------|--------|
| **pfSense** | 14+ | 6% (49% validation) | ✅ Passing |
| **TrueNAS** | 20+ | Framework ready | ✅ Ready |
| **iDRAC** | 11+ | 15% (91% validation) | ✅ Passing |
| **Proxmox** | 18+ | 11% (72% validation) | ✅ Passing |

### Running Tests

```bash
# Navigate to any project
cd 

# Install test dependencies
pip install pytest pytest-cov pytest-asyncio pytest-mock

# Run all tests
pytest tests/ -v

# Run with coverage report
pytest tests/ --cov=src --cov-report=html

# Run specific test file
pytest tests/test_validation.py -v
```

### Code Quality Checks

Run code quality checks locally on all projects:

```bash
# Run all quality checks (black, isort, flake8, mypy, bandit, safety, interrogate)
./run_code_quality_checks.sh
```

See [CODE_QUALITY.md](./CODE_QUALITY.md) for detailed code quality standards and tools.

### CI/CD

Automated checks run on every push and pull request via GitHub Actions:
- ✅ All 4 projects tested independently
- ✅ Coverage reports uploaded to Codecov
- ✅ Python 3.12 compatibility verified
- ✅ Code quality checks (linting, formatting, security, type checking)

See [TESTING.md](./TESTING.md) for detailed testing guide and [TEST_COVERAGE_SUMMARY.md](./TEST_COVERAGE_SUMMARY.md) for coverage details.

### Integration Testing

```bash
# Test with actual system (requires configuration)
python examples/basic_usage.py
```

## 📚 Documentation

Each project has detailed documentation:

- **Individual READMEs** in each project directory
- **[CLAUDE.md](CLAUDE.md)** - Development guidelines and architecture overview for AI assistant integration
- **[CODE_QUALITY.md](CODE_QUALITY.md)** - Code quality standards and tools documentation
- **API Documentation** in `docs/` folders
- **Example scripts** in `examples/` directories
- **Deployment guides** for Docker and Kubernetes

## 🛠️ Development

### Project Structure

```
project-name/
├── src/                    # Source code
│   ├── auth.py            # Authentication
│   ├── client.py          # API client
│   ├── server.py          # MCP server
│   └── utils/             # Utilities
├── tests/                 # Test files
├── examples/              # Example usage
├── docker/                # Docker files
├── k8s/                   # Kubernetes manifests
├── docs/                  # Documentation
├── requirements.txt       # Python dependencies
├── env.example           # Environment template
└── README.md             # Project documentation
```

### Adding New Features

1. **Update source code** in `src/`
2. **Add tests** in `tests/`
3. **Update documentation** in `docs/`
4. **Test thoroughly** before deployment

## 🚨 Important Notes

### ✅ Production Ready Projects

All MCP servers in this collection are now **production ready** and have been thoroughly tested:

- **pfSense MCP** - Firewall and network management
- **TrueNAS MCP** - Storage and NAS management  
- **iDRAC MCP** - Dell PowerEdge server management
- **Proxmox MCP** - Virtualization platform management

These servers have been tested with real systems and include comprehensive error handling, input validation, and security features.

### 🔒 Security

- **Never commit** `.env` files or credentials
- **Use strong passwords** and API keys
- **Restrict network access** appropriately
- **Monitor logs** for suspicious activity
- **Keep dependencies updated**

## 🤝 Contributing

1. **Fork the repository**
2. **Create a feature branch**
3. **Make your changes**
4. **Add tests** for new functionality
5. **Update documentation**
6. **Submit a pull request**

## 📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

## 🆘 Support

- **Issues**: Create GitHub issues for bugs or feature requests
- **Documentation**: Check individual project READMEs
- **Examples**: Review `examples/` directories for usage patterns

## 🔗 Related Links

- [Model Context Protocol](https://modelcontextprotocol.io/)
- [pfSense Documentation](https://docs.netgate.com/)
- [TrueNAS Documentation](https://www.truenas.com/docs/)
- [Dell iDRAC Documentation](https://www.dell.com/support/manuals/)
- [Proxmox VE Documentation](https://pve.proxmox.com/wiki/)

---

**Happy Infrastructure Management! 🎉**

## Source & license

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

- **Author:** [filthyrake](https://github.com/filthyrake)
- **Source:** [filthyrake/damens_mcps](https://github.com/filthyrake/damens_mcps)
- **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:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **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-filthyrake-damens-mcps
- Seller: https://agentstack.voostack.com/s/filthyrake
- 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%.