@mithung/vunet-mcp-server 2.0.6 → 2.1.0

package/index.js

@@ -26,7 +26,7 @@ class VunetMCPServer {
     this.server = new Server(
       {
         name: "vunet-mcp-server",
-        version: "2.0.6",
+        version: "2.0.8",
       },
       {
         capabilities: {
@@ -117,6 +117,7 @@ class VunetMCPServer {
 
   /**
    * Login to Vunet tenant
+   * Uses /vuSmartMaps/api/1/bu/{buId}/auth/users/login/ endpoint
    */
   async login() {
     const url = `${this.normalizeTenantUrl(this.tenantUrl)}/vuSmartMaps/api/1/bu/${this.buId}/auth/users/login/`;
@@ -129,6 +130,9 @@ class VunetMCPServer {
           password: this.password,
         },
         {
+          headers: {
+            "Content-Type": "application/json",
+          },
           httpsAgent: this.httpsAgent,
         }
       );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mithung/vunet-mcp-server",
-  "version": "2.0.6",
+  "version": "2.1.0",
   "description": "Model Context Protocol (MCP) Server for Vunet vuSmartMaps - Multi-tenant observability platform integration",
   "main": "index.js",
   "type": "module",
@@ -11,7 +11,15 @@
   "scripts": {
     "start": "node index.js",
     "dev": "node --watch index.js",
-    "test": "echo \"No tests specified yet\" && exit 0"
+    "test": "echo \"No tests specified yet\" && exit 0",
+    "build": "npm run validate && npm pack --dry-run",
+    "validate": "node --check index.js && node --check cli.js",
+    "prepublishOnly": "npm run validate && npm test",
+    "publish:dry": "npm publish --dry-run",
+    "publish:prod": "npm publish --access public",
+    "version:patch": "npm version patch -m \"Release v%s\"",
+    "version:minor": "npm version minor -m \"Release v%s\"",
+    "version:major": "npm version major -m \"Release v%s\""
   },
   "keywords": [
     "mcp",
@@ -53,12 +61,6 @@
     "index.js",
     "cli.js",
     "README.md",
-    "SETUP.md",
-    "QUICKSTART.md",
-    "DATA_MODELS.md",
-    "CHANGELOG.md",
-    "LICENSE",
-    "config.example.json",
-    "mcp-config.example.json"
+    "LICENSE"
   ]
 }

package/CHANGELOG.md

@@ -1,128 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [2.0.6] - 2026-02-13
-
-### Fixed
-- **CRITICAL FIX**: Corrected metric query endpoint to use `/api/metrics/` as per VuNet API documentation
-- Fixed query parameters to use snake_case format (relative_time, start_time, end_time) per VuNet API spec
-- URL encoding for metric names with spaces now works correctly
-- Removed incorrect path variations (/query/ and /vuSmartMaps/api/1/bu/1/metrics/)
-- Verified working with actual VuNet tenant
-
-## [2.0.5] - 2026-02-13
-
-### Fixed
-- Added URL encoding for metric names in query path (e.g., "Traces Transaction Volume" → "Traces%20Transaction%20Volume")
-- Metrics with spaces in names now query correctly
-
-## [2.0.4] - 2026-02-13
-
-### Fixed
-- **CRITICAL FIX**: Changed metric query endpoint from `/metrics/` to `/query/`
-- Fixed query parameter names to use VuNet camelCase format (relativeTime, startTime, endTime)
-- Metrics now query correctly against VuNet tenant
-
-## [2.0.3] - 2026-02-13
-
-### Fixed
-- Fixed metric query API endpoint to use correct VuNet path structure
-- Changed from `/api/metrics/` to `/vuSmartMaps/api/1/bu/{buId}/metrics/`
-- Improved error messages to include full error details for better debugging
-- Fixed retry logic to use correct URL on re-authentication
-
-## [2.0.1] - 2026-02-13
-
-### Fixed
-- Updated all documentation with correct package name (@mithung/vunet-mcp-server)
-- Fixed installation commands in README, SETUP, and QUICKSTART guides
-- Updated GitHub repository URLs
-
-## [2.0.0] - 2026-02-13
-
-### Added
-- New tool: `vunet_list_data_models` - List 80+ data models by category
-- DATA_MODELS.md - Comprehensive data model reference documentation
-- Bearer token authentication support (alternative to username/password)
-- Enhanced configuration examples with dual authentication methods
-
-### Changed
-- Package scoped under @mithung namespace
-- Version bumped to 2.0.0 for major feature additions
-
-## [1.0.0] - 2026-02-13
-
-### Added
-- Initial release of @mithung/vunet-mcp-server
-- Multi-tenant support for Vunet vuSmartMaps
-- MCP tools: `vunet_query_metric` and `vunet_get_status`
-- Session-based authentication with automatic token management
-- Support for 80+ data models including:
-  - Trace Map Data (individual spans)
-  - Traces Transaction Volume (aggregated metrics)
-  - Kubernetes metrics
-  - Infrastructure metrics
-  - Custom business metrics
-- Flexible time range queries:
-  - Relative time (`15m`, `1h`, `1d`, `1w`, `1M`, `1y`)
-  - Absolute time (epoch timestamps)
-  - Time shift comparisons
-- Dynamic filtering and field selection
-- SSL/TLS configuration support
-- Comprehensive documentation and examples
-- Configuration templates for VS Code MCP integration
-- npm package with CLI support (`vunet-mcp` command)
-
-### Features
-- Automatic session token refresh on expiry
-- Graceful cleanup and logout on exit
-- HTTPS agent with configurable SSL verification
-- Error handling with automatic retry on 401 (expired session)
-- Normalized tenant URL handling
-- Environment variable configuration
-- Compatible with GitHub Copilot, Claude, ChatGPT, and other MCP clients
-
-### Documentation
-- Comprehensive README.md with:
-  - Installation guide
-  - Quick start tutorial
-  - Multi-tenant configuration examples
-  - Query examples
-  - Troubleshooting guide
-  - API reference
-- Configuration templates:
-  - `config.example.json` - Environment variable schema
-  - `mcp-config.example.json` - Multi-tenant VS Code setup
-- License: MIT
-- .npmignore for clean package distribution
-
-### Developer Experience
-- `npm start` - Run the server
-- `npm run dev` - Run with watch mode
-- `npm pack` - Create distributable package
-- Global installation support via `npm install -g`
-
-## [Unreleased]
-
-### Planned
-- Unit tests and integration tests
-- CI/CD pipeline setup
-- Additional data model presets
-- Performance optimizations
-- Enhanced error messages
-- TypeScript support
-- GraphQL query support
-- Dashboard templates library
-- Webhook notifications
-- Scheduled queries
-- Data export utilities
-
----
-
-## Version History
-
-- **1.0.0** (2026-02-13): Initial release with core MCP functionality

package/DATA_MODELS.md

@@ -1,192 +0,0 @@
-# Vunet Data Models Reference
-
-This document lists common data models available in Vunet vuSmartMaps tenants. Use these names with the `vunet_query_metric` tool.
-
-> **Note:** Actual available models depend on your tenant configuration. Use the `vunet_list_data_models` tool to get the curated list programmatically.
-
-## Application Performance Monitoring (APM)
-
-### Traces & Transactions
-- `Trace Map Data` - Individual trace spans with detailed timing, status codes, and attributes
-- `Traces Transaction Volume` - Aggregated transaction counts and statistics
-- `Application Response Time` - Response time metrics across services
-- `Error Rate` - Error tracking and failure analysis
-- `Service Dependencies` - Service-to-service relationships
-- `Endpoint Performance` - API endpoint metrics
-
-### Application Metrics
-- `JVM Metrics` - Java Virtual Machine statistics
-- `Thread Pool Metrics` - Thread utilization
-- `GC Metrics` - Garbage collection performance
-- `Hibernate Query Performance` - ORM query performance
-- `Cache Hit Ratio` - Cache effectiveness metrics
-
-## Infrastructure Monitoring
-
-### Kubernetes
-- `Kubernetes Pod Metrics` - Pod-level resource usage and health
-- `Kubernetes Node Metrics` - Node-level system metrics
-- `Kubernetes Deployment Metrics` - Deployment status and scaling
-- `Kubernetes Service Metrics` - Service mesh metrics
-- `Kubernetes Namespace Metrics` - Namespace-level aggregations
-- `Container Metrics` - Container resource consumption
-- `Kubernetes Events` - Cluster events and alerts
-
-### System Resources
-- `CPU Usage` - CPU utilization by host/process
-- `Memory Usage` - Memory consumption and availability
-- `Disk I/O` - Disk read/write operations
-- `Network I/O` - Network traffic metrics
-- `File System Usage` - Disk space utilization
-- `System Load` - System load averages
-
-### Servers
-- `Apache Metrics` - Apache web server statistics
-- `Nginx Metrics` - Nginx performance metrics
-- `Tomcat Metrics` - Tomcat application server metrics
-- `IIS Metrics` - Internet Information Services metrics
-
-## Database Monitoring
-
-### Relational Databases
-- `MySQL Performance` - MySQL query performance and connections
-- `MySQL Slow Queries` - Slow query analysis
-- `PostgreSQL Metrics` - PostgreSQL database metrics
-- `Oracle Metrics` - Oracle database performance
-- `SQL Server Metrics` - Microsoft SQL Server statistics
-- `Database Connection Pool` - Connection pool utilization
-
-### NoSQL Databases
-- `MongoDB Metrics` - MongoDB performance
-- `Redis Metrics` - Redis cache metrics
-- `Cassandra Metrics` - Cassandra cluster health
-- `Elasticsearch Metrics` - Elasticsearch search performance
-
-## Network Monitoring
-
-- `Network Latency` - Network response times
-- `Packet Loss` - Network packet loss statistics
-- `Bandwidth Usage` - Network bandwidth consumption
-- `TCP Connections` - TCP connection tracking
-- `DNS Query Performance` - DNS resolution metrics
-- `SSL Certificate Expiry` - Certificate monitoring
-
-## Business Metrics
-
-- `VuBank Metrics` - Custom business metrics (example tenant)
-- `Transaction Success Rate` - Business transaction success/failure
-- `User Sessions` - User session analytics
-- `Revenue Metrics` - Business revenue tracking
-- `Conversion Rate` - Conversion funnel metrics
-- `Customer Activity` - User engagement metrics
-
-## Log Analytics
-
-- `Application Logs` - Application log aggregations
-- `Error Logs` - Error and exception logs
-- `Security Logs` - Security event logs
-- `Audit Logs` - Audit trail logs
-- `Access Logs` - HTTP access logs
-
-## Security & Compliance
-
-- `Security Events` - Security incident tracking
-- `Failed Login Attempts` - Authentication failures
-- `Privileged Access` - Privileged user activity
-- `Vulnerability Scan Results` - Security scan findings
-- `Compliance Metrics` - Compliance status metrics
-
-## Custom & Integration
-
-- Custom data models defined in your tenant
-- Third-party integration metrics
-- Business-specific KPIs
-
----
-
-## Query Examples
-
-### Get Slow Traces (Last 24 Hours)
-```json
-{
-  "metric_name": "Trace Map Data",
-  "relative_time": "24h",
-  "filters": {
-    "span.duration": ">5000000"
-  }
-}
-```
-
-### Kubernetes Pod CPU Usage
-```json
-{
-  "metric_name": "Kubernetes Pod Metrics",
-  "relative_time": "1h",
-  "include": "pod_name,cpu_usage,namespace"
-}
-```
-
-### Database Query Performance
-```json
-{
-  "metric_name": "MySQL Performance",
-  "relative_time": "30m",
-  "filters": {
-    "query_time": ">1000"
-  }
-}
-```
-
-### Error Rate by Service
-```json
-{
-  "metric_name": "Error Rate",
-  "relative_time": "2h",
-  "filters": {
-    "service_name": "api-gateway"
-  }
-}
-```
-
----
-
-## Discovery Methods
-
-### 1. Use MCP Tool (Recommended)
-```
-vunet_list_data_models
-```
-
-### 2. Ask via Natural Language
-```
-"What data models are available?"
-"Show me all Kubernetes metrics"
-"List APM data models"
-```
-
-### 3. Query Specific Categories
-```
-"Show infrastructure metrics"
-"List database performance models"
-"What application metrics can I query?"
-```
-
----
-
-## Data Model Naming Conventions
-
-- **Spaces in Names**: Use exact names with spaces (e.g., `"Trace Map Data"`)
-- **Case Sensitive**: Names are case-sensitive
-- **Special Characters**: Some models may contain hyphens or underscores
-- **Tenant-Specific**: Custom models follow your organization's naming
-
-## Need Help?
-
-- Check your Vunet UI for available data models
-- Use `vunet_get_status` to verify connection
-- Contact Vunet support for custom model documentation
-
----
-
-**Last Updated:** February 2026  
-**Package Version:** 1.0.0

package/QUICKSTART.md

@@ -1,213 +0,0 @@
-# 🚀 Vunet MCP Server - Quick Start Card
-
-## Package Name
-**`@mithung/vunet-mcp-server`** - v2.0.0
-
----
-
-## Install
-
-### Global (Recommended - After Publishing)
-```bash
-npm install -g @mithung/vunet-mcp-server
-```
-
-### From Tarball (Internal Distribution)
-```bash
-npm pack
-npm install -g vunet-mcp-server-1.0.0.tgz
-```
-
-### From Source (Development)
-```bash
-npm install
-npm link
-```
-
----
-
-## Configure
-
-### Single Tenant
-
-Create `.vscode/mcp.json`:
-
-**Username/Password:**
-```json
-{
-  "mcpServers": {
-    "vunet": {
-      "command": "npx",
-      "args": ["@mithung/vunet-mcp-server"],
-      "env": {
-        "VUNET_TENANT_URL": "https://your-tenant.com",
-        "VUNET_USERNAME": "username",
-        "VUNET_PASSWORD": "password",
-        "VUNET_BU_ID": "1",
-        "VUNET_VERIFY_SSL": "true"
-      }
-    }
-  }
-}
-```
-
-**Bearer Token:**
-```json
-{
-  "mcpServers": {
-    "vunet": {
-      "command": "npx",
-      "args": ["@mithung/vunet-mcp-server"],
-      "env": {
-        "VUNET_TENANT_URL": "https://your-tenant.com",
-        "VUNET_BEARER_TOKEN": "your-token-here",
-        "VUNET_BU_ID": "1",
-        "VUNET_VERIFY_SSL": "true"
-      }
-    }
-  }
-}
-```
-
-### Multiple Tenants
-
-```json
-{
-  "mcpServers": {
-    "vunet-prod": {
-      "command": "npx",
-      "args": ["@mithung/vunet-mcp-server"],
-      "env": { "VUNET_TENANT_URL": "...", ... }
-    },
-    "vunet-staging": {
-      "command": "npx",
-      "args": ["@mithung/vunet-mcp-server"],
-      "env": { "VUNET_TENANT_URL": "...", ... }
-    }
-  }
-}
-```
-
----
-
-## Use
-
-### In VS Code (GitHub Copilot Chat)
-
-```
-Show me traces from the last 2 days
-```
-
-```
-Get Kubernetes metrics for the last 15 minutes
-```
-
-```
-Create a performance report for slow traces
-```
-
-### Multi-Tenant
-
-```
-@vunet-prod show error rate for last hour
-@vunet-staging compare with yesterday
-```
-
----
-
-## Publish
-
-```bash
-# 1. Login
-npm login
-
-# 2. Publish
-npm publish --access public
-
-# 3. Done!
-# Team can now: npm install -g @mithung/vunet-mcp-server
-```
-
----
-
-## Files Created
-
-✅ `package.json` - npm package config
-✅ `index.js` - MCP server
-✅ `README.md` - Full documentation (14KB)
-✅ `SETUP.md` - Quick setup guide
-✅ `CHANGELOG.md` - Version history
-✅ `PUBLISHING.md` - Publishing guide
-✅ `LICENSE` - MIT License
-✅ `config.example.json` - Config template
-✅ `mcp-config.example.json` - Multi-tenant template
-✅ `.npmignore` - Package exclusions
-
----
-
-## Environment Variables
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `VUNET_TENANT_URL` | ✅ | - | Tenant URL |
-| `VUNET_USERNAME` | ✅* | - | Username (*or use bearer token) |
-| `VUNET_PASSWORD` | ✅* | - | Password (*or use bearer token) |
-| `VUNET_BEARER_TOKEN` | ✅* | - | Bearer token (*or use username/password) |
-| `VUNET_BU_ID` | ❌ | `1` | Business Unit |
-| `VUNET_VERIFY_SSL` | ❌ | `true` | SSL verify |
-
----
-
-## MCP Tools
-
-1. **`vunet_query_metric`**
-   - Query any data model
-   - Flexible time ranges
-   - Dynamic filters
-   
-2. **`vunet_get_status`**
-   - Connection status
-   - Authentication status
-   - Session info
-
----
-
-## Data Models (80+)
-
-- Trace Map Data
-- Traces Transaction Volume
-- Kubernetes Pod Metrics
-- Kubernetes Node Metrics
-- VuBank Metrics
-- ... and 75+ more
-
----
-
-## Next Steps
-
-1. ✅ **Test Locally** - Already working!
-2. 📦 **Publish npm** - `npm publish`
-3. 👥 **Share Team** - Config template
-4. 📈 **Monitor** - GitHub Issues
-
----
-
-## Documentation
-
-📖 Full Guide → [README.md](README.md)
-⚙️ Setup → [SETUP.md](SETUP.md)
-📦 Publishing → [PUBLISHING.md](PUBLISHING.md)
-📋 Summary → [PACKAGE_SUMMARY.md](PACKAGE_SUMMARY.md)
-
----
-
-## Support
-
-🐛 Issues: GitHub Issues
-💬 Docs: README.md
-📧 Email: support@vunetsystems.com
-
----
-
-**Made with ❤️ by Vunet Systems**
-**Powered by Model Context Protocol**