MCP Server Nekzus

🌟 Features

• 🔄 MCP Protocol Implementation
• 🛠️ Integrated Utility Tools
• 📝 Schema Validation with Zod
• 🚀 ESM Support
• 🔒 Strict TypeScript Types
• 🧩 Extensible Architecture for New Tools

🛠️ Available Tools

1. greeting

Generates a personalized greeting message.

Parameters:

• name (string): Recipient's name

Example:

// Result: 👋 Hello John! Welcome to the MCP server!
{
  name: "John";
}

2. card

Gets a random card from a standard poker deck.

Parameters:

• No parameters required

Example:

// Result: 🎴 You drew: Ace of ♠️ Spades
{}

3. datetime

Gets the current date and time for a specific timezone.

Parameters:

• timeZone (string, optional): Timezone identifier (e.g., "America/New_York")
• locale (string, optional): Locale identifier (e.g., "en-US")

Example:

// Result: 
// 🗓️ Date: March 20, 2024
// ⏰ Time: 7:25:25 PM
// 🌍 Timezone: America/New_York
{
  timeZone: "America/New_York",
  locale: "en-US"
}

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:

// 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:

// 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:

// 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:

// 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

1. Global Installation:

npm install -g @nekzus/mcp-server

2. Execution:

npx @nekzus/mcp-server

As a Dependency

import { McpUtilityServer } from "@nekzus/mcp-server";

const server = new McpUtilityServer();
server.start();

🔧 Development

# Clone repository
git clone https://github.com/nekzus/mcp-server.git

# Install dependencies
npm install

# Development mode
npm run dev

# Build
npm run build

# Run
npm start

📁 Project Structure

src/
├── types/          # Type definitions
│   └── index.ts    # Shared types
├── utils/          # Utilities
│   ├── cards.ts    # Card functions
│   ├── datetime.ts # Date/time functions
│   └── schema.ts   # Schema conversion
├── tools/          # Tool implementations
│   └── index.ts    # Tools registry
└── index.ts        # Main entry point

🔍 Technical Details

• Transport: Uses StdioServerTransport for communication
• Validation: Converts JSON schemas to Zod for input validation
• Types: Fully typed implementation with TypeScript
• Error Handling: Robust error handling and resource cleanup
• Signals: Handles SIGTERM and SIGINT signals for graceful shutdown

📄 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

🌟 Support

Give a ⭐️ if this project helped you!