Provides development tools and runtime environment for the MCP server, using Bun as the recommended JavaScript runtime and package manager for installation and execution.
Incorporates ESLint for code quality checking with a dedicated script for linting the codebase.
Offers package distribution through JSR registry, allowing installation via the @danielbodnar/vyos-mcp package for simplified deployment.
Provides specific configuration instructions for macOS users setting up Claude Desktop integration with the MCP server.
Utilizes TypeScript with strict configuration for type safety throughout the codebase, enabling strongly-typed interactions with the VyOS API.
Implements Zod schema validation for runtime type checking of all API operations, ensuring data integrity when interacting with VyOS systems.
VyOS MCP Server
A comprehensive Model Context Provider (MCP) server for VyOS network operating system automation. This server provides complete access to VyOS functionality through 25+ tools covering configuration management, operational commands, system administration, network diagnostics, and monitoring.
🚀 Features
Complete VyOS API Coverage: All endpoints from VyOS HTTPS API
Type Safety: Full TypeScript with Zod schema validation
MCP Compatible: Works with Claude Desktop and other MCP clients
Streaming Support: SSE transport for real-time communication
OpenAPI v3.1: Auto-generated API documentation
Error Handling: Robust error management with proper HTTP status codes
📋 Requirements
Bun v1.0+ (JavaScript runtime and package manager)
TypeScript v5.6+ with strict configuration
VyOS system with HTTPS API enabled
MCP Client (Claude Desktop, etc.)
🛠️ Installation
From JSR (Recommended)
From Source
Using as a Library (JSR)
🔧 Configuration
VyOS System Setup
Enable the HTTPS API on your VyOS system:
MCP Client Configuration
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json
on macOS):
🎯 Usage
1. Connect to VyOS System
2. Configuration Management
3. Network Diagnostics
4. System Monitoring
🔍 Available Tools
Authentication
vyos-connect
- Connect to VyOS system
Configuration Management
vyos-show-config
- Retrieve configurationvyos-set-config
- Set configuration valuesvyos-delete-config
- Delete configuration nodesvyos-config-exists
- Check configuration existencevyos-return-values
- Get configuration valuesvyos-commit
- Commit pending changesvyos-save-config
- Save to startup config
Operational Commands
vyos-show-operational
- Execute show commandsvyos-reset
- Execute reset commandsvyos-generate
- Execute generate commands
System Management
vyos-system-info
- Get system informationvyos-reboot
- Reboot systemvyos-poweroff
- Power off systemvyos-health-check
- Comprehensive health assessment
Network Interface Management
vyos-configure-interface
- Configure interface settingsvyos-interface-stats
- Get interface statistics
Routing
vyos-configure-static-route
- Configure static routesvyos-routing-table
- Display routing tablevyos-bgp-status
- Get BGP status
Network Diagnostic Tools
vyos-ping
- Ping connectivity testvyos-traceroute
- Traceroute network analysis
📖 Documentation
API Documentation - Complete TypeDoc-generated documentation
OpenAPI Specification - REST API specification
VyOS Official Docs - VyOS documentation
Scripts
🏗️ Architecture
Type Safety
Zod Schemas: All API operations use Zod for runtime validation
TypeScript: Strict typing throughout the codebase
Generated Types: Type definitions derived from schemas
Error Handling
HTTP Status Codes: Proper 200/400/500 responses
VyOS API Errors: Translated to meaningful messages
Network Timeouts: Configurable timeout handling
Connection Management: Automatic retry and reconnection
Streaming
SSE Transport: Server-Sent Events for real-time communication
Bridge Pattern: Connects MCP server to transport layer
CORS Support: Cross-origin requests for web clients
🤝 Contributing
Fork the repository
Create a feature branch
Add comprehensive JSDoc documentation
Include TypeScript type definitions
Add error handling and validation
Update tests and documentation
Submit a pull request
📄 License
MIT License - see LICENSE file for details.
🆘 Support
Issues: GitHub Issues
VyOS Documentation: docs.vyos.io
MCP Specification: Model Context Protocol
Built with ❤️ for network automation and infrastructure management.
This server cannot be installed
A Model Context Provider server offering comprehensive access to VyOS network operating system functionality through 25+ tools covering configuration management, operational commands, diagnostics, and monitoring.
Related MCP Servers
- -securityFlicense-qualityProvides a scalable, containerized infrastructure for deploying and managing Model Context Protocol servers with monitoring, high availability, and secure configurations.Last updated -
- -securityAlicense-qualityA Model Context Protocol server that provides file system operations, analysis, and manipulation capabilities through a standardized tool interface.Last updated -5MIT License
- -securityAlicense-qualityA Model Context Protocol server that provides programmatic access to ONOS SDN controller's network management capabilities, enabling device control, topology management, and analytics through ONOS's REST API.Last updated -4GPL 3.0
- AsecurityAlicenseAqualityA comprehensive Model Context Protocol server providing access to 70+ IT tools for developers and system administrators, including encoding/decoding, text manipulation, hashing, and network utilities.Last updated -762012TypeScriptMIT License