Alteon MCP Server

Professional Model Context Protocol (MCP) server for Radware Alteon Application Delivery Controllers. Provides comprehensive monitoring, topology discovery, configuration validation, and management capabilities through AI-powered interfaces.

Features

🎯 Comprehensive Tool Suite (18 Tools)

Phase 1: Core Monitoring (7 tools)

• Real server status and health monitoring
• Service group status tracking
• Virtual service monitoring
• System health metrics
• VLAN information
• Network traffic statistics
• Overall device status

Phase 2: Server & Group Management (3 tools)

• Real server listing and details
• Service group configuration and members
• Health check status validation

Phase 3: Network Topology (4 tools)

• IP interface discovery
• VLAN detailed configuration
• Network topology summary
• Gateway configuration

Phase 4: Configuration Validation (4 tools)

• Configuration synchronization checking
• Server configuration validation
• Service group validation
• Comprehensive configuration audit reports

🚀 Key Capabilities

• ✅ Production Ready: Thoroughly tested with 100% pass rate (18/18 tools)
• ✅ Safe Operations: Read-only validation tools, no configuration changes
• ✅ AI-Powered: Integrates with Claude, ChatGPT, and other MCP-compatible AI systems
• ✅ TypeScript: Fully typed for reliability and maintainability
• ✅ REST API: Clean integration with Alteon REST API
• ✅ Enterprise Grade: Designed for professional network operations

Installation

NPM Installation (Recommended)

npm install -g alteon-mcp-server

From Source

git clone https://github.com/rdwr-seanr/alteon-mcp-server.git
cd alteon-mcp-server
npm install
npm run build

Prerequisites

• Node.js: v18.0.0 or higher
• Alteon Device: With REST API enabled
• Network Access: HTTPS connectivity to Alteon
• Credentials: Valid admin credentials

Configuration

Configure your MCP client to connect to your Alteon device. The server supports multiple configuration methods:

Claude Desktop Configuration

Add to your Claude Desktop config file (claude_desktop_config.json):

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "alteon": {
      "command": "node",
      "args": [
        "C:\\path\\to\\alteon-mcp-server\\dist\\index.js"
      ],
      "env": {
        "ALTEON_HOST": "10.210.240.96",
        "ALTEON_USERNAME": "admin",
        "ALTEON_PASSWORD": "admin"
      }
    }
  }
}

LM Studio Configuration

Create lm-studio-config.json in the project root:

{
  "host": "10.210.240.96",
  "username": "admin",
  "password": "admin"
}

Environment Variables

# Linux/macOS
export ALTEON_HOST=10.210.240.96
export ALTEON_USERNAME=admin
export ALTEON_PASSWORD=admin

# Windows PowerShell
$env:ALTEON_HOST="10.210.240.96"
$env:ALTEON_USERNAME="admin"
$env:ALTEON_PASSWORD="admin"

Usage

With Claude Desktop

Once configured, simply ask Claude natural language questions about your Alteon device:

"Show me the status of all real servers"
"Which service groups have unhealthy members?"
"Generate a configuration audit report"
"Check if there are any pending configuration changes"
"What's the current network topology?"
"Show me traffic statistics for port 2"
"List all IP interfaces and their VLANs"

With LM Studio

1. Start LM Studio and load your preferred model
2. Enable MCP servers in settings
3. The Alteon tools will be available for the AI to use
4. Ask questions naturally about your network infrastructure

Command Line Testing

Verify your installation and connectivity:

# Run comprehensive test suite
npm test

# Expected output: 18/18 tests passing

Example Outputs

Real Server Status:

Server 1: 10.210.240.5 (Web-Server-1)
  Status: Enabled
  State: Up
  Weight: 1
  Max Connections: 10000

Configuration Validation:

Configuration Synchronization Status:
✅ Real Servers: Synchronized (3 pending, 3 active)
✅ Service Groups: Synchronized
✅ VLANs: Synchronized

Validation: All configurations in sync

Network Topology:

Network Topology Summary:
- VLANs: 6 configured
- IP Interfaces: 4 configured
- Real Servers: 3 active
- Service Groups: 4 configured

Available Tools

Monitoring Tools

• get_real_server_status - Get all real servers with health status
• get_service_group_status - Get all service groups with member counts
• get_virtual_service_status - Get all virtual services
• get_system_health - Get system health metrics
• get_vlan_info - Get VLAN configuration
• get_traffic_stats - Get network traffic statistics
• check_device_status - Get overall device status

Management Tools

• list_real_servers - List all real servers with details
• get_service_group_details - Get detailed service group configuration
• get_health_check_status - Get health check status for all servers

Topology Tools

• get_ip_interfaces - Get IP interface configuration
• get_vlan_details - Get detailed VLAN information
• get_network_summary - Get complete network topology
• get_gateway_config - Get gateway configuration

Validation Tools

• check_config_sync - Check configuration synchronization status
• validate_server_config - Validate real server configurations
• validate_service_group - Validate service group configurations
• generate_config_report - Generate comprehensive audit report

Requirements

• Node.js: 18.0.0 or higher
• Alteon ADC: Compatible with REST API (tested on v32+)
• Network Access: HTTPS connectivity to Alteon device
• Credentials: Valid Alteon admin credentials

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run tests
npm test

# Clean build artifacts
npm run clean

Testing

The project includes comprehensive test coverage:

npm test

Expected output:

🎉 SUCCESS! All 18 tools are working perfectly!

📋 Tool Categories:
   • Phase 1: 7 Core Monitoring Tools
   • Phase 2: 3 Server & Group Management Tools
   • Phase 3: 4 Network Topology Tools
   • Phase 4: 4 Configuration Validation Tools

✨ Ready for production deployment!

Architecture

alteon-mcp-server/
├── src/
│   └── index.ts          # Main MCP server implementation
├── dist/                 # Compiled JavaScript (npm package)
├── test-all-18-tools.mjs # Comprehensive test suite
├── package.json          # NPM package configuration
└── tsconfig.json         # TypeScript configuration

Security Considerations

• HTTPS Only: All communication uses HTTPS (self-signed certs accepted)
• Credentials: Store credentials securely using environment variables
• Read-Only: All tools are read-only, no configuration changes
• Validation: Extensive input validation and error handling
• Network: Ensure proper network segmentation for management access

Troubleshooting

Connection Issues

# Test Alteon connectivity
curl -k https://10.210.240.96/config/SlbCurCfgEnhRealServerTable -u admin:admin

Tool Failures

• Verify Alteon firmware version (REST API availability varies)
• Check credentials and network connectivity
• Review tool logs for specific error messages
• Some advanced tools require specific Alteon features

Common Issues

404 Errors: Some API endpoints may not be available on older Alteon versions Timeout Errors: Increase timeout in axios configuration Auth Errors: Verify username/password and account permissions

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Changelog

See CHANGELOG.md for version history.

Roadmap

See ROADMAP.md for planned features and future development.

License

MIT License - see LICENSE file for details.

Author

Sean Ramati

• Email: [email protected]
• GitHub: @rdwr-seanr

Acknowledgments

• Built with Model Context Protocol SDK
• Designed for Radware Alteon ADC
• Inspired by the need for AI-powered network operations

Support

• 📖 Documentation
• 🐛 Issue Tracker
• 💬 Discussions

⚡ Built for AI-Powered Network Operations