MCP Servers Collection
A collection of Model Context Protocol (MCP) servers that extend Claude Desktop's capabilities by providing access to various external systems and services.
Available MCP Servers
🌐 Network MCP Server
Status: ✅ Complete and Functional
Location: network-mcp-server/
Provides access to network filesystems including SMB/CIFS shares, with extensibility for NFS, FTP, and other protocols.
Features:
- SMB/CIFS support for Windows shares and Samba servers
- 7 MCP tools for file operations (read, write, list, delete, create directories, get info)
- Comprehensive security controls and validation
- Claude Desktop integration ready
🔍 Code Linter MCP Server
Status: ✅ Complete and Functional
Location: code-linter-mcp-server/
Comprehensive code linting and validation for multiple programming languages with Serena workflow integration.
Features:
- Multi-language support (Python, Go, JavaScript, TypeScript, YAML, JSON)
- 6 MCP tools for code quality validation
- Serena Integration: Blocks code saves when quality standards aren't met
- Security validation and content scanning
- Concurrent linter execution with result caching
Critical Integration: Ensures Serena never saves code that hasn't passed quality validation.
🖥️ Proxmox MCP Server
Status: ✅ Complete and Functional
Location: proxmox-mcp-server/
Comprehensive Proxmox VE datacenter management through Model Context Protocol with full migration from standalone scripts.
Features:
- 12 comprehensive MCP tools for complete Proxmox management
- VM/Container lifecycle management (create, start, stop, delete)
- Snapshot and backup operations with automated cleanup
- Health assessments and resource monitoring
- Storage optimization and maintenance automation
- Multi-server support with security validation
- Migration: Fully replaces 8+ standalone scripts with enhanced functionality
Key Tools: System info, health assessment, VM/container management, snapshot operations, backup management, storage optimization, maintenance automation, audit reporting.
📊 WikiJS MCP Server
Status: ✅ Complete and Functional
Location: wikijs-mcp-server/
WikiJS documentation management and markdown processing with automated content migration.
Features:
- 12 MCP tools for complete WikiJS documentation management
- Markdown file discovery and analysis
- Automated content migration to WikiJS
- Document validation and metadata extraction
- Search and retrieval capabilities
- Bulk operations with progress tracking
🗄️ TrueNAS MCP Server
Status: ✅ Complete and Functional
Location: truenas-mcp-server/
TrueNAS Core management through natural language commands with comprehensive storage operations.
Features:
- 15+ MCP tools for complete TrueNAS management
- Storage pool and dataset management
- User administration and permissions control
- Snapshot and backup automation
- SMB/NFS share management
- iSCSI targets for Kubernetes integration
- ZFS property management (compression, deduplication, quotas)
- Kubernetes Ready: Export NFS shares and create iSCSI targets
Key Tools: Storage pools, datasets, users, permissions, snapshots, shares, backups, system monitoring.
🐙 GitHub MCP Server
Status: ✅ Production Ready (Forked from GitHub Official)
Location: github-mcp-server/
Official GitHub MCP Server providing comprehensive GitHub API integration for repository management, issues, pull requests, and project boards.
Features:
- Complete GitHub API access through MCP protocol
- Repository management (create, update, delete, fork)
- Issues and pull requests management
- Project boards and labels administration
- GitHub Actions workflow integration
- OAuth and Personal Access Token authentication
- Remote and local deployment options
Key Tools: Repository operations, issue management, pull request workflows, project board management, GitHub Actions integration, user and organization management.
🗺️ Development Roadmap
🐙 GitHub MCP Server: Project Board Support Enhancement
Priority: High | Phase: Phase 1 Development
Target Completion: Q1 2025
Enhance the forked GitHub MCP Server with comprehensive project board management capabilities that are currently missing from the official implementation.
Phase 1: Core Project Board Features (High Priority)
📋 Project Board Creation & Management
- Create new project boards with customizable templates
- Configure board settings and automation rules
- Board deletion and archival operations
- Template-based board creation for standardized workflows
🎯 Column Management
- Create, update, and delete project board columns
- Reorder columns and configure column automation
- Custom column types and field configurations
- Column limits and WIP (Work In Progress) constraints
🎴 Card Operations
- Add issues and pull requests to project boards
- Move cards between columns programmatically
- Update card metadata and custom fields
- Bulk card operations and batch processing
Phase 2: Advanced Automation (Medium Priority)
⚙️ Workflow Automation
- Automated card movement based on issue/PR status
- Custom automation rules and triggers
- Integration with GitHub Actions workflows
- Event-driven card updates and notifications
📊 Cross-Repository Project Management
- Multi-repository project board support
- Organization-level project management
- Repository linking and dependency tracking
- Unified project dashboard across repositories
Phase 3: Template & Integration Features (Medium Priority)
📐 Project Templates
- Standardized project board templates (Kanban, Scrum, Bug Triage)
- Template customization and sharing
- Quick project setup from templates
- Template versioning and updates
🔗 Advanced Integrations
- Project progress reporting and analytics
- Integration with external project management tools
- Custom field types and validation
- Export/import functionality for project data
Technical Implementation Plan
- New MCP Tools: 15+ specialized tools for project board operations
- API Integration: GitHub Projects API v2 GraphQL integration
- Authentication: OAuth and PAT support with proper scoping
- Error Handling: Comprehensive error handling with retry logic
- Performance: Optimized queries and caching for large projects
- Testing: Unit and integration tests for all project board operations
Success Metrics
- Feature Parity: Complete project board management capabilities
- Performance: Sub-200ms response times for project operations
- Reliability: 99.9% operation success rate
- Integration: Seamless Claude Desktop integration with project workflows
- Adoption: Enhanced project management capabilities for all MCP users
Development Environment
- Primary Development:
C:\git\mcp-servers\(GitHub synchronized) - Temporary Work:
C:\working\(volatile, short-term only)
Quick Start
Network MCP Server
cd network-mcp-server
pip install -e .
network-mcp-server create-config --output config.json
Code Linter MCP Server
cd code-linter-mcp-server
pip install -e .
pip install flake8 black mypy yamllint # Install Python linters
code-linter-mcp-server create-config --output config.json
Proxmox MCP Server
cd proxmox-mcp-server
./install.sh # Creates virtual environment and installs dependencies
./venv/bin/proxmox-mcp-server create-config --output config.json
# Edit config.json with your Proxmox server details
export PROXMOX_PASSWORD='your_password'
./venv/bin/proxmox-mcp-server validate-config config.json --test-connection
Claude Desktop Integration
Add to your Claude Desktop configuration:
{
"mcpServers": {
"network-fs": {
"command": "network-mcp-server",
"args": ["run", "--config", "path/to/network-config.json"]
},
"code-linter": {
"command": "code-linter-mcp-server",
"args": ["run", "--config", "path/to/linter-config.json"]
},
"proxmox": {
"command": "path/to/proxmox-mcp-server/venv/bin/proxmox-mcp-server",
"args": ["run", "path/to/proxmox-config.json"],
"env": {
"PROXMOX_PASSWORD": "your_password"
}
},
"github": {
"command": "path/to/github-mcp-server/github-mcp-server",
"args": [],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token"
}
}
}
}
Project Standards
All servers follow consistent patterns:
- Architecture: Pydantic configuration, async operations, security validation
- CLI: Standard commands (run, create-config, validate-config)
- Testing: Comprehensive test coverage with pytest
- Documentation: README, examples, and installation guides
- Security: File type restrictions, path validation, audit logging
Development Workflow
- Create new server directory:
[purpose]-mcp-server/ - Follow established directory structure and patterns
- Implement security validation and error handling
- Add comprehensive tests and documentation
- Update this main README
Future MCP Server Ideas
- Database MCP Server: SQL database access and management
- Home Assistant MCP Server: Smart home control and monitoring
- Git MCP Server: Repository operations and GitHub/GitLab integration
- Docker MCP Server: Container management and monitoring
- AWS/Cloud MCP Server: Cloud resource management
Contributing
See individual server directories for specific setup and contribution guidelines. All development follows the established patterns and quality standards.
License
MIT License - see individual server LICENSE files for details.