@mithung/vunet-mcp-server 2.0.0

package/CHANGELOG.md

@@ -0,0 +1,79 @@
+# 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).
+
+## [1.0.0] - 2026-02-13
+
+### Added
+- Initial release of @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

@@ -0,0 +1,192 @@
+# 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/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vunet Systems
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/QUICKSTART.md

@@ -0,0 +1,213 @@
+# 🚀 Vunet MCP Server - Quick Start Card
+
+## Package Name
+**`@vunet/mcp-server`** - v1.0.0
+
+---
+
+## Install
+
+### Global (Recommended - After Publishing)
+```bash
+npm install -g @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": ["@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": ["@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": ["@vunet/mcp-server"],
+      "env": { "VUNET_TENANT_URL": "...", ... }
+    },
+    "vunet-staging": {
+      "command": "npx",
+      "args": ["@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 @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**