@nekzus/mcp-server 1.0.34 → 1.0.36

package/README.md

@@ -79,6 +79,129 @@ Gets the current date and time for a specific timezone.
 }
 ```
 
+### 4. calculator
+
+Performs mathematical calculations with support for basic and advanced operations.
+
+**Parameters:**
+
+- `expression` (string): Mathematical expression (e.g., "2 + 2 * 3")
+- `precision` (number, optional): Decimal places in the result (default: 2)
+
+**Example:**
+
+```typescript
+// Result: 8
+{
+  expression: "2 + 2 * 3"
+}
+```
+
+### 5. passwordGen
+
+Generates secure passwords with customizable options.
+
+**Parameters:**
+
+- `length` (number, optional): Password length (default: 16)
+- `includeNumbers` (boolean, optional): Include numbers (default: true)
+- `includeSymbols` (boolean, optional): Include special characters (default: true)
+- `includeUppercase` (boolean, optional): Include uppercase letters (default: true)
+
+**Example:**
+
+```typescript
+// Result: 4v7&9G8$
+{
+  length: 16,
+  includeNumbers: true,
+  includeSymbols: true,
+  includeUppercase: true
+}
+```
+
+### 6. qrGen
+
+Generates QR codes for text or URLs.
+
+**Parameters:**
+
+- `text` (string): Text or URL to encode
+- `size` (number, optional): Size in pixels (default: 200)
+- `dark` (string, optional): Dark module color (default: "#000000")
+- `light` (string, optional): Light module color (default: "#ffffff")
+
+**Example:**
+
+```typescript
+// Result: QR code for "https://example.com"
+{
+  text: "https://example.com"
+}
+```
+
+### 7. kitchenConvert
+
+Converts between common kitchen measurements and weights, including volume-to-weight conversions based on specific ingredients.
+
+**Parameters:**
+
+- `value` (number): Value to convert
+- `from` (string): Source unit (e.g., "cup", "tbsp", "g", "oz", "ml")
+- `to` (string): Target unit (e.g., "cup", "tbsp", "g", "oz", "ml")
+- `ingredient` (string, optional): Ingredient for accurate volume-to-weight conversions
+
+**Supported Units:**
+
+*Volume:*
+- ml (milliliters)
+- l (liters)
+- cup (US cup)
+- tbsp (tablespoon)
+- tsp (teaspoon)
+- floz (fluid ounce)
+
+*Weight:*
+- g (grams)
+- kg (kilograms)
+- oz (ounces)
+- lb (pounds)
+
+**Supported Ingredients:**
+- water
+- milk
+- flour
+- sugar
+- brown sugar
+- salt
+- butter
+- oil
+- honey
+- maple syrup
+
+**Examples:**
+
+```typescript
+// Simple volume conversion
+// Result: 🔄 Conversion Result:
+// • 1 cup = 236.59 ml
+{
+  value: 1,
+  from: "cup",
+  to: "ml"
+}
+
+// Volume to weight conversion with ingredient
+// Result: 🔄 Conversion Result:
+// • 1 cup of flour = 140.25 g
+{
+  value: 1,
+  from: "cup",
+  to: "g",
+  ingredient: "flour"
+}
+```
+
 ## 🚀 Usage
 
 ### As MCP Server

package/package.json

@@ -1,29 +1,23 @@
 {
   "name": "@nekzus/mcp-server",
-  "version": "1.0.34",
+  "version": "1.0.36",
   "description": "Personal MCP Server implementation providing extensible utility functions and tools for development and testing purposes",
   "type": "module",
-  "main": "./dist/index.js",
   "bin": {
     "mcp-server": "./dist/index.js"
   },
   "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
+    "dist"
   ],
   "scripts": {
-    "build": "tsc && shx chmod +x dist/index.js",
-    "dev": "tsx src/index.ts",
+    "build": "tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"",
     "start": "node dist/index.js",
     "test": "jest --passWithNoTests",
     "format": "biome format --write .",
     "lint": "biome lint --write .",
     "check": "biome check --apply .",
     "commit": "git-cz",
-    "semantic-release": "semantic-release --branches main",
-    "prepare": "npm run build",
-    "watch": "tsc --watch"
+    "semantic-release": "semantic-release --branches main"
   },
   "keywords": [
     "mcp",
@@ -55,13 +49,11 @@
     "@semantic-release/npm": "12.0.1",
     "@semantic-release/release-notes-generator": "14.0.3",
     "@types/jest": "29.5.14",
-    "@types/node": "22.13.10",
+    "@types/node": "22.13.11",
     "cz-conventional-changelog": "3.3.0",
-    "jest": "^29.7.0",
+    "jest": "29.7.0",
     "semantic-release": "24.2.3",
-    "shx": "0.4.0",
     "ts-jest": "29.2.6",
-    "tsx": "4.19.3",
     "typescript": "5.8.2"
   },
   "config": {

package/dist/index.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import 'dotenv/config';

package/dist/index.js

@@ -1,180 +0,0 @@
-#!/usr/bin/env node
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import 'dotenv/config';
-// Define the tools once to avoid repetition
-const TOOLS = [
-    {
-        name: 'greeting',
-        description: 'Generate a personalized greeting message for the specified person',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                name: {
-                    type: 'string',
-                    description: 'Name of the recipient for the greeting',
-                },
-            },
-            required: ['name'],
-        },
-    },
-    {
-        name: 'card',
-        description: 'Draw a random card from a standard 52-card poker deck',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                random_string: {
-                    type: 'string',
-                    description: 'Dummy parameter for no-parameter tools',
-                },
-            },
-            required: ['random_string'],
-        },
-    },
-    {
-        name: 'datetime',
-        description: 'Get the current date and time for a specific timezone',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                timeZone: {
-                    type: 'string',
-                    description: 'Timezone identifier (e.g., "America/New_York")',
-                },
-                locale: {
-                    type: 'string',
-                    description: 'Locale identifier (e.g., "en-US")',
-                },
-            },
-        },
-    },
-];
-// Tool handlers
-async function handleGreeting(args) {
-    const { name } = args;
-    return {
-        content: [
-            {
-                type: 'text',
-                text: `¡Hola ${name}! ¿Cómo estás?`,
-            },
-        ],
-        isError: false,
-    };
-}
-async function handleCard() {
-    const suits = ['♠', '♥', '♦', '♣'];
-    const values = ['A', '2', '3', '4', '5', '6', '7', '8', '9', '10', 'J', 'Q', 'K'];
-    const suit = suits[Math.floor(Math.random() * suits.length)];
-    const value = values[Math.floor(Math.random() * values.length)];
-    return {
-        content: [
-            {
-                type: 'text',
-                text: `${value}${suit}`,
-            },
-        ],
-        isError: false,
-    };
-}
-async function handleDateTime(args) {
-    const { timeZone = 'UTC', locale = 'en-US' } = args;
-    try {
-        const date = new Date();
-        const formattedDate = new Intl.DateTimeFormat(locale, {
-            timeZone,
-            dateStyle: 'full',
-            timeStyle: 'long',
-        }).format(date);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: formattedDate,
-                },
-            ],
-            isError: false,
-        };
-    }
-    catch (error) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-}
-// Tool call handler
-async function handleToolCall(name, args) {
-    switch (name) {
-        case 'greeting':
-            return handleGreeting(args);
-        case 'card':
-            return handleCard();
-        case 'datetime':
-            return handleDateTime(args);
-        default:
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Unknown tool: ${name}`,
-                    },
-                ],
-                isError: true,
-            };
-    }
-}
-// Server configuration
-const server = new Server({
-    name: '@nekzus/mcp-server',
-    version: '0.1.0',
-    description: 'MCP Server implementation for development',
-}, {
-    capabilities: {
-        tools: {},
-    },
-});
-// Setup request handlers
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools: TOOLS,
-}));
-server.setRequestHandler(CallToolRequestSchema, async (request) => handleToolCall(request.params.name, request.params.arguments ?? {}));
-// Server startup
-async function runServer() {
-    try {
-        const transport = new StdioServerTransport();
-        await server.connect(transport);
-        console.log('[Server] MCP Server is running');
-        console.log('[Server] Available tools:', TOOLS.map((t) => t.name).join(', '));
-        // Handle stdin close
-        process.stdin.on('close', () => {
-            console.log('[Server] Input stream closed');
-            cleanup();
-        });
-    }
-    catch (error) {
-        console.error('[Server] Failed to start MCP Server:', error);
-        process.exit(1);
-    }
-}
-// Cleanup function
-async function cleanup() {
-    try {
-        await server.close();
-        console.log('[Server] MCP Server stopped gracefully');
-        process.exit(0);
-    }
-    catch (error) {
-        console.error('[Server] Error during cleanup:', error);
-        process.exit(1);
-    }
-}
-// Start the server
-runServer().catch(console.error);