@nekzus/mcp-server 1.2.0 → 1.3.0

package/README.md

@@ -1,4 +1,4 @@
-# Nekzus MCP Server
+# @nekzus/mcp-server
 
 [![Github Workflow](https://github.com/nekzus/mcp-server/actions/workflows/publish.yml/badge.svg?event=push)](https://github.com/Nekzus/mcp-server/actions/workflows/publish.yml)
 [![npm-version](https://img.shields.io/npm/v/@nekzus/mcp-server.svg)](https://www.npmjs.com/package/@nekzus/mcp-server)
@@ -8,177 +8,161 @@
 
 <div align="center">
 
-**A Model Context Protocol (MCP) server that provides utility tools for
-development and testing** </br>_This implementation is built on top of the
-official MCP SDK and offers an extensible architecture for adding new tools_
+**A Model Context Protocol (MCP) server for comprehensive NPM package analysis** </br>
+_Built on the MCP SDK, providing real-time insights into package quality, security, dependencies, and metrics_
 
 </div>
 
-## Components
+## Features
 
-### Tools
+- **Version Analysis**
+  - List all available package versions
+  - Get latest version details
+  - Track version history
+  - Analyze release patterns
 
-- **greeting**
-  - Generate personalized greeting messages
-  - Input: `name` (string, required): Name of the recipient
+- **Package Analysis**
+  - Check dependencies and devDependencies
+  - Verify TypeScript support
+  - Analyze package size and dependencies
+  - Scan for vulnerabilities
+  - Monitor security updates
+
+- **Metrics Analysis**
+  - Track download trends
+  - Compare package metrics
+  - Evaluate quality scores
+  - Assess maintenance status
+  - Monitor popularity trends
+
+## Tools
+
+### Version Analysis Tools
+
+- **npmVersions**
+  - Get all available versions of a package
+  - Input: `packageName` (string, required)
   - Example:
     ```json
-    {"name": "John"} -> "👋 Hello John! Welcome to the MCP server!"
+    {"packageName": "react"} -> Lists all react versions
     ```
 
-- **card**
-  - Draw random cards from a standard 52-card poker deck
-  - Input: No parameters required
+- **npmLatest**
+  - Get latest version info and changelog
+  - Input: `packageName` (string, required)
   - Example:
     ```json
-    {} -> "🎴 Drew card: A♠️" (random from 52 cards)
+    {"packageName": "react"} -> Latest version details
     ```
 
-- **datetime**
-  - Get formatted date/time for any timezone
-  - Inputs:
-    - `timeZone` (string, optional, default: "UTC"): Timezone identifier
-    - `locale` (string, optional, default: "en-US"): Locale for formatting
+### Package Analysis Tools
+
+- **npmDeps**
+  - Analyze package dependencies
+  - Input: `packageName` (string, required)
   - Example:
     ```json
-    {"timeZone": "America/New_York", "locale": "es-ES"} -> 
-    "🕒 domingo, 24 de marzo de 2024, 15:25:25 hora de verano del este"
+    {"packageName": "react"} -> Dependencies breakdown
     ```
 
-- **calculator**
-  - Perform mathematical calculations
-  - Inputs:
-    - `expression` (string, required): Mathematical expression to evaluate
-    - `precision` (number, optional, default: 2): Number of decimal places
-  - Supported operations: +, -, *, /, %, (), .
+- **npmTypes**
+  - Check TypeScript support
+  - Input: `packageName` (string, required)
   - Example:
     ```json
-    {"expression": "2 + 2 * 3", "precision": 2} -> "🔢 Result: 8.00"
-    {"expression": "(15 / 2) % 2", "precision": 3} -> "🔢 Result: 1.500"
+    {"packageName": "react"} -> TypeScript support info
     ```
 
-- **passwordGen**
-  - Generate secure passwords with customizable options
-  - Inputs:
-    - `length` (number, optional, default: 16): Password length
-    - `includeNumbers` (boolean, optional, default: true): Include numbers
-    - `includeSymbols` (boolean, optional, default: true): Include special symbols
-    - `includeUppercase` (boolean, optional, default: true): Include uppercase letters
+- **npmSize**
+  - Get package size metrics
+  - Input: `packageName` (string, required)
   - Example:
     ```json
-    {"length": 12, "includeSymbols": true} -> "🔐 Generated: Kj2$mP9&vN4x"
-    {"length": 8, "includeNumbers": false} -> "🔐 Generated: KjMpNvXw"
+    {"packageName": "react"} -> Size and dependency info
     ```
 
-- **qrGen**
-  - Generate QR codes for text or URLs
+- **npmVulnerabilities**
+  - Check security vulnerabilities
+  - Input: `packageName` (string, required)
+  - Example:
+    ```json
+    {"packageName": "react"} -> Security vulnerabilities
+    ```
+
+### Metrics Analysis Tools
+
+- **npmTrends**
+  - Get download trends
   - Inputs:
-    - `text` (string, required): Text or URL to encode
-    - `size` (number, optional, default: 200): Size in pixels
-    - `dark` (string, optional, default: "#000000"): Color for dark modules
-    - `light` (string, optional, default: "#ffffff"): Color for light modules
-  - Output: Returns a Data URL containing the QR code image
+    - `packageName` (string, required)
+    - `period` (string, optional): "last-week" | "last-month" | "last-year"
   - Example:
     ```json
-    // Basic Usage
-    {"text": "https://github.com/nekzus"} -> 
-    "📱 QR Code generated successfully!
-     Properties:
-     • Content: https://github.com/nekzus
-     • Size: 200px
-     • Dark Color: #000000
-     • Light Color: #ffffff
-     
-     QR Code (Data URL):
-     data:image/png;base64,..."
-
-    // Custom Size and Colors
     {
-      "text": "Hello World!",
-      "size": 300,
-      "dark": "#FF0000",
-      "light": "#FFFFFF"
-    } -> 
-    "📱 QR Code generated successfully!
-     Properties:
-     • Content: Hello World!
-     • Size: 300px
-     • Dark Color: #FF0000
-     • Light Color: #FFFFFF
-     
-     QR Code (Data URL):
-     data:image/png;base64,..."
+      "packageName": "react",
+      "period": "last-month"
+    } -> Download trends data
     ```
 
-  **Note:** The QR code is returned as a Data URL that can be used directly in HTML `<img>` tags or converted to a file.
+- **npmCompare**
+  - Compare multiple packages
+  - Input: `packages` (string[], required)
+  - Example:
+    ```json
+    {
+      "packages": ["react", "vue", "angular"]
+    } -> Comparative metrics
+    ```
 
-- **kitchenConvert**
-  - Convert between kitchen measurements
-  - Inputs:
-    - `value` (number, required): Value to convert
-    - `from` (string, required): Source unit
-    - `to` (string, required): Target unit
-    - `ingredient` (string, optional): Ingredient for accurate conversion
-  
-  **Supported Units:**
-  
-  *Volume Units:*
-  ```
-  - ml    (milliliters)
-  - l     (liters)
-  - cup   (US cup = 236.588 ml)
-  - tbsp  (US tablespoon = 14.787 ml)
-  - tsp   (US teaspoon = 4.929 ml)
-  - floz  (US fluid ounce = 29.574 ml)
-  ```
-
-  *Weight Units:*
-  ```
-  - g     (grams)
-  - kg    (kilograms)
-  - oz    (ounces = 28.350 g)
-  - lb    (pounds = 453.592 g)
-  ```
-
-  **Ingredient Densities:**
-  ```
-  - water        (1.000 g/ml)
-  - milk         (1.030 g/ml)
-  - flour        (0.593 g/ml)
-  - sugar        (0.845 g/ml)
-  - brown_sugar  (0.721 g/ml)
-  - salt         (1.217 g/ml)
-  - butter       (0.911 g/ml)
-  - oil          (0.918 g/ml)
-  - honey        (1.420 g/ml)
-  - maple_syrup  (1.370 g/ml)
-  ```
-
-  Examples:
-  ```json
-  // Volume to Volume
-  {"value": 1, "from": "cup", "to": "ml"} -> 
-  "⚖️ 1 cup = 236.59 ml"
-
-  // Weight to Weight
-  {"value": 500, "from": "g", "to": "lb"} -> 
-  "⚖️ 500 g = 1.10 lb"
-
-  // Volume to Weight (requires ingredient)
-  {"value": 1, "from": "cup", "to": "g", "ingredient": "flour"} -> 
-  "⚖️ 1 cup of flour = 140.30 g"
-  ```
+- **npmQuality**
+  - Get quality metrics
+  - Input: `packageName` (string, required)
+  - Example:
+    ```json
+    {"packageName": "react"} -> Quality score details
+    ```
+
+- **npmMaintenance**
+  - Get maintenance metrics
+  - Input: `packageName` (string, required)
+  - Example:
+    ```json
+    {"packageName": "react"} -> Maintenance status
+    ```
+
+- **npmPopularity**
+  - Get popularity metrics
+  - Input: `packageName` (string, required)
+  - Example:
+    ```json
+    {"packageName": "react"} -> Popularity metrics
+    ```
 
 ## Key Features
 
+- Real-time package analysis
+- Comprehensive security scanning
+- Detailed dependency tracking
+- TypeScript support verification
+- Performance metrics monitoring
 - Zero configuration required
-- JSON-RPC 2.0 compliant
 - Type-safe implementations
-- Emoji-enhanced responses
-- Comprehensive error handling
-- ESM support
-- Full TypeScript types
+- Full TypeScript declarations
 - Docker support
+- ESM support
+
+## Installation
+
+```bash
+# NPM
+npm install @nekzus/mcp-server
+
+# Yarn
+yarn add @nekzus/mcp-server
+
+# PNPM
+pnpm add @nekzus/mcp-server
+```
 
 ## Configuration
 
@@ -244,7 +228,7 @@ npm run build
 
 ## Docker
 
-Build the Docker image:
+Build and run the Docker image:
 
 ```bash
 # Build the image
@@ -254,24 +238,11 @@ docker build -t nekzus/mcp-server .
 docker run -i --rm --init nekzus/mcp-server
 ```
 
-## Contributing
+## Requirements
 
-1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes using commitizen (`npm run commit`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
+- Node.js >= 18
+- npm >= 9
 
 ## License
 
-This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
-
-## Author
-
-👤 **nekzus**
-
-* GitHub: [@Nekzus](https://github.com/Nekzus)
-
-## Show your support
-
-Give a ⭐️ if this project helped you!
+MIT © [nekzus](https://github.com/nekzus)

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+declare function handleNpmVersions(args: {
+    packageName: string;
+}): Promise<CallToolResult>;
+declare function handleNpmLatest(args: {
+    packageName: string;
+}): Promise<CallToolResult>;
+declare function handleNpmDeps(args: {
+    packageName: string;
+}): Promise<CallToolResult>;
+declare function handleNpmTypes(args: {
+    packageName: string;
+}): Promise<CallToolResult>;
+declare function handleNpmSize(args: {
+    packageName: string;
+}): Promise<CallToolResult>;
+declare function handleNpmVulnerabilities(args: {
+    packageName: string;
+}): Promise<CallToolResult>;
+declare function handleNpmTrends(args: {
+    packageName: string;
+    period?: string;
+}): Promise<CallToolResult>;
+declare function handleNpmCompare(args: {
+    packages: string[];
+}): Promise<CallToolResult>;
+declare function handleNpmQuality(args: {
+    packageName: string;
+}): Promise<CallToolResult>;
+declare function handleNpmMaintenance(args: {
+    packageName: string;
+}): Promise<CallToolResult>;
+declare function handleNpmPopularity(args: {
+    packageName: string;
+}): Promise<CallToolResult>;
+export { handleNpmCompare, handleNpmDeps, handleNpmLatest, handleNpmMaintenance, handleNpmPopularity, handleNpmQuality, handleNpmSize, handleNpmTrends, handleNpmTypes, handleNpmVersions, handleNpmVulnerabilities, };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,EAAE,cAAc,EAAQ,MAAM,oCAAoC,CAAC;AAiT/E,iBAAe,iBAAiB,CAAC,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAwCvF;AAED,iBAAe,eAAe,CAAC,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAyDrF;AAED,iBAAe,aAAa,CAAC,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAqDnF;AAED,iBAAe,cAAc,CAAC,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAwCpF;AAED,iBAAe,aAAa,CAAC,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAuCnF;AAED,iBAAe,wBAAwB,CAAC,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CA6D9F;AAED,iBAAe,eAAe,CAAC,IAAI,EAAE;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,cAAc,CAAC,CA8B1B;AAED,iBAAe,gBAAgB,CAAC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAoDrF;AAGD,iBAAe,gBAAgB,CAAC,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CA4CtF;AAGD,iBAAe,oBAAoB,CAAC,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CA4C1F;AAGD,iBAAe,mBAAmB,CAAC,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CA4CzF;AAGD,OAAO,EACN,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,wBAAwB,GACxB,CAAC"}