damens_mcps MCP server
Commit Nov 9, 2026Enables AI assistants to manage infrastructure components including pfSense firewalls, TrueNAS storage, Dell iDRAC servers, and Proxmox virtualization.
Also known as filthyrake/damens_mcps, damens-mcps
- Stars
- 2
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 9, 2026
- License
- MIT
What is damens_mcps MCP?
damens_mcps enables AI assistants to manage infrastructure components including pfSense firewalls, TrueNAS storage, Dell iDRAC servers, and Proxmox virtualization.
Summary generated from the project's README
About damens_mcps MCP server
This collection of MCP servers provides a standardized way for AI assistants to manage diverse infrastructure components. It includes dedicated servers for pfSense firewalls, TrueNAS storage, Dell iDRAC server management, and Proxmox virtualization platforms. Developers can use these tools to automate network, storage, and server administration through a unified interface.
Setup requires Python 3.8 or higher and valid API credentials or system passwords for each target platform. While pfSense and iDRAC are designed for direct Python execution, the TrueNAS and Proxmox servers support containerized deployment via Docker and orchestration through Kubernetes. Users must configure environment variables such as host addresses and API keys to establish connections to their local or remote hardware.
Written from the project's README. Every use case is checked against a quote from it.
Configuration
PFSENSE_API_KEYPFSENSE_HOSTPFSENSE_PASSWORDPFSENSE_USERNAMETRUENAS_API_KEYTRUENAS_HOSTTRUENAS_PASSWORDTRUENAS_USERNAME
| Name | Description | |
|---|---|---|
| PFSENSE_API_KEY | — | |
| PFSENSE_HOST | — | |
| PFSENSE_PASSWORD | — | |
| PFSENSE_USERNAME | — | |
| TRUENAS_API_KEY | — | |
| TRUENAS_HOST | — | |
| TRUENAS_PASSWORD | — | |
| TRUENAS_USERNAME | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablefilthyrake/damens_mcps is public and reachablegithub.com/filthyrake/damens_mcps ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-09github.com/filthyrake/damens_mcps ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubDamen's MCP Servers Collection 🚀
Note: These MCP servers were generated using Cursor 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 | ✅ Production Ready | Firewall and network management for pfSense |
| TrueNAS MCP | ✅ Production Ready | Storage and NAS management for TrueNAS |
| iDRAC MCP | ✅ Production Ready | Dell PowerEdge server management via iDRAC |
| 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
-
Clone the repository:
git clone <your-repo-url> cd damens_mcps -
Choose your project and navigate to it:
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) -
Set up virtual environment:
python3 -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate pip install -r requirements.txt -
Configure environment:
cp env.example .env # Edit .env with your system credentials -
Start the server:
# 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:
# 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:
# 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:
# 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:
# 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
# Navigate to any project
cd <project-name>
# 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:
# Run all quality checks (black, isort, flake8, mypy, bandit, safety, interrogate)
./run_code_quality_checks.sh
See 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 for detailed testing guide and TEST_COVERAGE_SUMMARY.md for coverage details.
Integration Testing
# 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 - Development guidelines and architecture overview for AI assistant integration
- 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
- Update source code in
src/ - Add tests in
tests/ - Update documentation in
docs/ - 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
.envfiles or credentials - Use strong passwords and API keys
- Restrict network access appropriately
- Monitor logs for suspicious activity
- Keep dependencies updated
🤝 Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests for new functionality
- Update documentation
- 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
- pfSense Documentation
- TrueNAS Documentation
- Dell iDRAC Documentation
- Proxmox VE Documentation
Happy Infrastructure Management! 🎉
damens_mcps MCP questions
Can I deploy these servers using Docker or Kubernetes?
Docker and Kubernetes support is available specifically for the TrueNAS MCP and Proxmox MCP projects.
Are these servers suitable for production use?
Yes, the pfSense, TrueNAS, iDRAC, and Proxmox MCP servers are listed as production ready and have been tested with real systems.