@mithung/vunet-mcp-server

Model Context Protocol (MCP) Server for Vunet vuSmartMaps - A multi-tenant observability platform integration.

Query metrics, traces, logs, and data models from your Vunet tenants using natural language through AI assistants like Claude, GitHub Copilot, or any MCP-compatible client.

Latest Version: 2.1.1 - Updated repository URLs, authentication improvements with proxy support.

🚀 Features

• ✅ Multi-Tenant Support - Connect to multiple Vunet tenants simultaneously
• 🔐 Secure Authentication - Session-based auth with automatic token refresh
• 📊 Comprehensive Data Access - Query 600+ data models including:
  • Journey Metrics (IBMB, UPI, CBS, FRM)
  • Application traces and exceptions
  • Infrastructure metrics (CPU, Memory, Disk)
  • Kubernetes metrics
  • Alert data and RCA metrics
• ⚡ Flexible Querying - Support for:
  • Relative time ranges (5m, 15m, 1h, 2h, 1d, 1w, 1M)
  • Absolute time ranges (epoch timestamps)
  • Dynamic filters and field selection
• 🔄 Auto Session Management - Handles login, token refresh, and logout
• 🌐 Proxy Support - Works with Traefik and other reverse proxies

📦 Installation

Using npx (Recommended - No Installation Required)

npx @mithung/vunet-mcp-server

Global Installation

npm install -g @mithung/vunet-mcp-server

Local Installation

npm install @mithung/vunet-mcp-server

🛠️ Configuration

VS Code / GitHub Copilot Setup

Create .vscode/mcp.json in your workspace:

{
  "servers": {
    "vunet": {
      "command": "npx",
      "args": ["@mithung/vunet-mcp-server"],
      "env": {
        "VUNET_TENANT_URL": "https://your-tenant.vunetsystems.com",
        "VUNET_USERNAME": "your-username",
        "VUNET_PASSWORD": "your-password",
        "VUNET_BU_ID": "1",
        "VUNET_VERIFY_SSL": "true"
      }
    }
  }
}

Multiple Tenants

{
  "servers": {
    "vunet-prod": {
      "command": "npx",
      "args": ["@mithung/vunet-mcp-server"],
      "env": {
        "VUNET_TENANT_URL": "https://prod.vunetsystems.com",
        "VUNET_USERNAME": "prod-user",
        "VUNET_PASSWORD": "prod-password",
        "VUNET_BU_ID": "1",
        "VUNET_VERIFY_SSL": "true"
      }
    },
    "vunet-uat": {
      "command": "npx",
      "args": ["@mithung/vunet-mcp-server"],
      "env": {
        "VUNET_TENANT_URL": "https://uat.vunetsystems.com",
        "VUNET_USERNAME": "uat-user",
        "VUNET_PASSWORD": "uat-password",
        "VUNET_BU_ID": "1",
        "VUNET_VERIFY_SSL": "false"
      }
    }
  }
}

Running from Source

If you've cloned the repository:

{
  "servers": {
    "vunet": {
      "command": "node",
      "args": ["c:\\path\\to\\vunet-mcp-server\\index.js"],
      "env": {
        "VUNET_TENANT_URL": "https://your-tenant.vunetsystems.com",
        "VUNET_USERNAME": "your-username",
        "VUNET_PASSWORD": "your-password",
        "VUNET_BU_ID": "1",
        "VUNET_VERIFY_SSL": "false"
      }
    }
  }
}

📊 Available MCP Tools

1. vunet_get_status

Check authentication status and session validity.

Example: "Check if Vunet connection is working"

2. vunet_list_data_models

List all available data models/metrics in the tenant.

Example: "List all available Vunet data models"

3. vunet_query_metric

Query a specific metric with time range and filters.

Parameters: | Parameter | Required | Description | |-----------|----------|-------------| | metric_name | Yes | Name of the data model to query | | relative_time | No | Time range: 5m, 15m, 1h, 2h, 1d, 1w, 1M | | start_time | No | Start epoch timestamp (for absolute range) | | end_time | No | End epoch timestamp (for absolute range) | | filters | No | JSON object with field:value filters |

💬 Usage Examples

Check Connection Status

"Is the Vunet MCP server connected?"

List Available Metrics

"What data models are available in Vunet?"

Query Journey Metrics

"Show me IBMB Journey Metrics for the last 2 hours"

Query Alerts

"Get all critical alerts from the last 1 hour"

Query with Filters

"Query IBMB Journey Metrics where name equals CBS for the last 30 minutes"

Infrastructure Monitoring

"Show CPU utilization for IBMB servers in the last hour"

RCA Analysis

"Get Technical Decline data for IBMB in the last 2 hours"

🔧 Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | VUNET_TENANT_URL | Yes | - | Vunet tenant URL | | VUNET_USERNAME | Yes | - | Username for authentication | | VUNET_PASSWORD | Yes | - | Password for authentication | | VUNET_BU_ID | Yes | 1 | Business Unit ID | | VUNET_VERIFY_SSL | No | true | Verify SSL certificates |

📈 Common Data Models

Journey Metrics

• IBMB Journey Metrics - Internet/Mobile Banking metrics
• UPI Journey Metrics - UPI payment metrics
• CBS Journey Metrics - Core Banking metrics
• FRM Journey Metrics - Fraud Risk Management

RCA (Root Cause Analysis)

• RCA IBMB TD - Technical Decline breakdown
• RCA CPU Utilization IBMB - Server CPU metrics
• RCA Memory Utilization IBMB - Server memory metrics
• Linux Disk Utilization IBMB - Disk usage

Alerts

• Alert data - All active alerts with severity
• IBMB Exceptions - Application exceptions

Infrastructure

• Kubernetes Pod Metrics
• Linux Host Metrics
• Network Metrics

🔥 Troubleshooting

Authentication Failed (401)

Error: www-authenticate: Basic realm="traefik"

Solution: Your environment may have a Traefik proxy. The MCP server v2.1.0+ handles this automatically.

Session Expired

The server automatically refreshes sessions. If issues persist, restart the MCP server.

SSL Certificate Errors

Set VUNET_VERIFY_SSL to false for self-signed certificates:

"VUNET_VERIFY_SSL": "false"

Data Model Not Found

Use vunet_list_data_models to see available metrics. Names are case-sensitive.

🚀 Quick Start Commands

# Install globally
npm install -g @mithung/vunet-mcp-server

# Or run directly with npx
npx @mithung/vunet-mcp-server

# Check installed version
npm list -g @mithung/vunet-mcp-server

📄 Changelog

v2.1.1 (2026-02-18)

• ✅ Updated repository URLs to correct GitHub organization
• ✅ Fixed package metadata

v2.1.0 (2026-02-17)

• ✅ Authentication improvements with proxy support
• ✅ Auto-reconnect on session expiry
• ✅ Better error handling

v2.0.8

• Initial stable release
• Multi-tenant support
• Comprehensive data model access

📝 License

MIT License - see LICENSE file.

🤝 Contributing

1. Fork the repository
2. Create your 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

📧 Support

• GitHub Issues: https://github.com/mithung-vunet/vunet-mcp-server/issues
• npm Package: https://www.npmjs.com/package/@mithung/vunet-mcp-server

Made with ❤️ by Vunet Systems