Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_FILE | No | Path to log file. If not set, logs will be sent to stdout only | |
| MCP_HOST | No | Host to bind to when using HTTP transport | 0.0.0.0 |
| MCP_PORT | No | Port to bind to when using HTTP transport | 8000 |
| NSO_PORT | No | NSO server port | 8080 |
| NSO_SCHEME | No | NSO connection scheme (http/https) | http |
| NSO_VERIFY | No | Verify NSO HTTPS certificate (default: True). Use --no-nso-verify for self-signed certs (dev only). | True |
| NSO_ADDRESS | No | NSO server address | localhost |
| NSO_TIMEOUT | No | Connection timeout in seconds | 10 |
| NSO_PASSWORD | No | NSO password | admin |
| NSO_USERNAME | No | NSO username | admin |
| MCP_TRANSPORT | No | MCP transport type (stdio/http) | stdio |
| NSO_CA_BUNDLE | No | Path to a CA bundle file to trust for NSO HTTPS. Applicable when -nso-verify is True. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {
"tasks": {
"list": {},
"cancel": {},
"requests": {
"tools": {
"call": {}
},
"prompts": {
"get": {}
},
"resources": {
"read": {}
}
}
}
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_service_types | Retrieve the available service types in Cisco NSO. |
| get_services | Retrieve the available services in Cisco NSO. Requires a 'service_type' parameter. |
| get_device_platform | Retrieve platform information for a specific device in Cisco NSO. Requires a 'device_name' parameter. |
| get_device_config | Retrieve the full configuration for a specific device in Cisco NSO. Requires a 'device_name' parameter. |
| get_device_state | Retrieve the state for a specific device in Cisco NSO. Requires a 'device_name' parameter. |
| get_device_groups | Retrieve the available device groups in Cisco NSO. |
| get_device_ned_ids | Retrieve the available Network Element Driver (NED) IDs in Cisco NSO. |
| check_device_sync | Check the sync status for a specific device in Cisco NSO. Requires a 'device_name' parameter. |
| sync_from_device | Sync from a specific device in Cisco NSO. Requires a 'device_name' parameter. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| nso_environment | NSO environment summary |