1
0
forked from rsp2k/mcp-mailu

4 Commits

Author SHA1 Message Date
68d429f80c Add comprehensive security automation tools
- Implement auto_configure_domain_security tool for complete domain security setup
- Add analyze_domain_security tool for security analysis and scoring
- Generate DKIM keys, extract DNS records, and provide security recommendations
- Calculate security scores based on DKIM, SPF, DMARC, and TLSA configurations
- Version bump to 0.3.0 for security enhancements

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-16 13:24:27 -06:00
3fe5bb02ad 🔄 Refactor API endpoints to use MCP resources vs tools (v0.3.0)
ARCHITECTURAL IMPROVEMENT: Proper separation of concerns in MCP design

📖 RESOURCES (Read-only data retrieval):
- mailu://users - All users
- mailu://domains - All domains
- mailu://aliases - All aliases
- mailu://alternative-domains - All alternative domains
- mailu://relays - All relays
- mailu://user/{email} - Specific user details
- mailu://domain/{domain} - Specific domain details
- mailu://alias/{alias} - Specific alias details
- mailu://alternative-domain/{alt} - Specific alternative domain
- mailu://relay/{name} - Specific relay details
- mailu://domain/{domain}/users - Users in specific domain
- mailu://domain/{domain}/managers - Managers for specific domain
- mailu://domain/{domain}/manager/{email} - Specific manager details
- mailu://alias/destination/{domain} - Aliases by destination domain

 TOOLS (Actions and modifications):
- create_user, update_user, delete_user
- create_domain, update_domain, delete_domain, generate_dkim_keys
- create_domain_manager, delete_domain_manager
- create_alias, update_alias, delete_alias
- create_alternative_domain, delete_alternative_domain
- create_relay, update_relay, delete_relay

 BENEFITS:
- Better UX: Resources are discoverable and browsable
- Cleaner separation: Read vs Write operations
- Structured data: Resources return properly formatted JSON
- URI-based access: RESTful resource addressing
- Improved performance: Resources can be cached by clients

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-16 13:16:44 -06:00
4f17a4e3bc 🚀 Add comprehensive Mailu API tool coverage (v0.2.0)
MASSIVE UPGRADE: Added 27 comprehensive tools covering ALL Mailu API endpoints:

📧 USER ENDPOINTS (5 tools):
- list_users, create_user, get_user, update_user, delete_user

🌐 DOMAIN ENDPOINTS (7 tools):
- list_domains, create_domain, get_domain, update_domain, delete_domain
- generate_dkim_keys, list_domain_users

👥 DOMAIN MANAGER ENDPOINTS (4 tools):
- list_domain_managers, create_domain_manager, get_domain_manager, delete_domain_manager

📍 ALIAS ENDPOINTS (6 tools):
- list_aliases, create_alias, get_alias, update_alias, delete_alias, find_aliases_by_domain

🔄 ALTERNATIVE DOMAIN ENDPOINTS (4 tools):
- list_alternative_domains, create_alternative_domain, get_alternative_domain, delete_alternative_domain

🔗 RELAY ENDPOINTS (5 tools):
- list_relays, create_relay, get_relay, update_relay, delete_relay

 FEATURES:
- Complete parameter coverage for all API endpoints
- Comprehensive error handling with try/catch blocks
- Proper request body construction for create/update operations
- All tools support the full Mailu API specification
- Backward compatible with existing basic tools

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-16 13:10:28 -06:00
66d1c0732a Initial commit: FastMCP server for Mailu email API integration
- Complete FastMCP server with OpenAPI integration and fallback tools
- Automatic tool generation from Mailu REST API endpoints
- Bearer token authentication support
- Comprehensive test suite and documentation
- PyPI-ready package configuration with proper metadata
- Environment-based configuration support
- Production-ready error handling and logging
- Examples and publishing scripts included

Features:
- User management (list, create, update, delete)
- Domain management (list, create, update, delete)
- Alias management and email forwarding
- DKIM key generation
- Manager assignment for domains
- Graceful fallback when OpenAPI validation fails

Ready for Claude Desktop integration and PyPI distribution.
2025-07-16 11:55:44 -06:00