@nekzus/mcp-server 0.0.0-development

package/README.md

@@ -0,0 +1,171 @@
+# 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)
+[![npm-month](https://img.shields.io/npm/dm/@nekzus/mcp-server.svg)](https://www.npmjs.com/package/@nekzus/mcp-server)
+[![npm-total](https://img.shields.io/npm/dt/@nekzus/mcp-server.svg?style=flat)](https://www.npmjs.com/package/@nekzus/mcp-server)
+[![Donate](https://img.shields.io/badge/donate-paypal-blue.svg?style=flat-square)](https://paypal.me/maseortega)
+
+<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_
+
+</div>
+
+## 🌟 Features
+
+- 🔄 MCP Protocol Implementation
+- 🛠️ Integrated Utility Tools
+- 📝 Schema Validation with Zod
+- 🚀 ESM Support
+- 🔒 Strict TypeScript Types
+- 🧩 Extensible Architecture for New Tools
+
+## 📦 Installation
+
+```bash
+# Global installation (recommended for CLI usage)
+npm install -g @nekzus/mcp-server
+
+# Local installation
+npm install @nekzus/mcp-server
+```
+
+## 🛠️ Available Tools
+
+### 1. greeting
+
+Generates a personalized greeting message.
+
+**Parameters:**
+
+- `name` (string): Recipient's name
+
+**Example:**
+
+```typescript
+// 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:**
+
+```typescript
+// 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:**
+
+```typescript
+// Result: 
+// 🗓️ Date: March 20, 2024
+// ⏰ Time: 7:25:25 PM
+// 🌍 Timezone: America/New_York
+{
+  timeZone: "America/New_York",
+  locale: "en-US"
+}
+```
+
+## 🚀 Usage
+
+### As MCP Server
+
+1. **Global Installation:**
+
+```bash
+npm install -g @nekzus/mcp-server
+```
+
+2. **Execution:**
+
+```bash
+npx @nekzus/mcp-server
+```
+
+### As a Dependency
+
+```typescript
+import { McpUtilityServer } from "@nekzus/mcp-server";
+
+const server = new McpUtilityServer();
+server.start();
+```
+
+## 🔧 Development
+
+```bash
+# 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
+
+MIT © [nekzus]
+
+## 👤 Author
+
+**Nekzus**
+
+- GitHub: [@nekzus](https://github.com/nekzus)
+
+## 🌟 Support
+
+Give a ⭐️ if this project helped you!

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+export declare class McpUtilityServer {
+    private readonly server;
+    private readonly transport;
+    private readonly tools;
+    constructor();
+    private registerTool;
+    private initializeTools;
+    start(): Promise<void>;
+    private cleanup;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAKA,OAAO,eAAe,CAAC;AAMvB,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;;IAkBxC,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,eAAe;IAQV,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAsBrB,OAAO;CAUxB"}

package/dist/index.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import 'dotenv/config';
+import availableTools from './tools/index.js';
+import { SchemaConverter } from './utils/schema.js';
+export class McpUtilityServer {
+    server;
+    transport;
+    tools;
+    constructor() {
+        this.server = new McpServer({
+            name: '@nekzus/mcp-server',
+            version: '1.0.0',
+            description: 'MCP Server implementation providing utility functions and tools for development and testing'
+        }, {
+            capabilities: {
+                resources: {},
+                tools: {}
+            }
+        });
+        this.transport = new StdioServerTransport();
+        this.tools = availableTools;
+    }
+    registerTool(tool) {
+        try {
+            console.log(`[Tool Registration] Registering tool: ${tool.name}`);
+            const zodSchema = SchemaConverter.toZod(tool.inputSchema);
+            const handler = tool.handler;
+            this.server.tool(tool.name, tool.description || '', zodSchema.shape, async (args, extra) => {
+                const result = await handler(args, extra);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(result)
+                        }]
+                };
+            });
+            console.log(`[Tool Registration] Successfully registered: ${tool.name}`);
+        }
+        catch (error) {
+            console.error(`[Tool Registration] Failed to register tool ${tool.name}:`, error);
+            throw error;
+        }
+    }
+    initializeTools() {
+        console.log(`[Server] Initializing ${this.tools.length} tools...`);
+        for (const tool of this.tools) {
+            this.registerTool(tool);
+        }
+        console.log('[Server] Tool initialization completed successfully');
+    }
+    async start() {
+        try {
+            this.initializeTools();
+            await this.server.connect(this.transport);
+            console.log('[Server] MCP Utility Server is running');
+            console.log('[Server] Available tools:', this.tools.map(t => t.name).join(', '));
+            // Handle termination signals
+            process.on('SIGTERM', () => this.cleanup());
+            process.on('SIGINT', () => this.cleanup());
+            // Handle stdin close
+            process.stdin.on('close', () => {
+                console.log('[Server] Input stream closed');
+                this.cleanup();
+            });
+        }
+        catch (error) {
+            console.error('[Server] Failed to start MCP Utility Server:', error);
+            throw error;
+        }
+    }
+    async cleanup() {
+        try {
+            await this.transport.close();
+            console.log('[Server] MCP Utility Server stopped gracefully');
+            process.exit(0);
+        }
+        catch (error) {
+            console.error('[Server] Error during cleanup:', error);
+            process.exit(1);
+        }
+    }
+}
+// Auto-start server if this is the main module
+if (import.meta.url === new URL(import.meta.url).href) {
+    const server = new McpUtilityServer();
+    server.start().catch((error) => {
+        console.error('[Server] Fatal error:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -0,0 +1,40 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const greetingTool: Tool;
+export declare const cardTool: Tool;
+export declare const dateTimeTool: Tool;
+declare const availableTools: readonly [{
+    [x: string]: unknown;
+    name: string;
+    inputSchema: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+    description?: string | undefined;
+}, {
+    [x: string]: unknown;
+    name: string;
+    inputSchema: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+    description?: string | undefined;
+}, {
+    [x: string]: unknown;
+    name: string;
+    inputSchema: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+    description?: string | undefined;
+}];
+export default availableTools;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAS5E,eAAO,MAAM,YAAY,EAAE,IAgC1B,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,IA+BtB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,IAuC1B,CAAC;AAGF,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAkD,CAAC;AACvE,eAAe,cAAc,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,114 @@
+import { getRandomCard } from '../utils/cards.js';
+import { getCurrentDateTime } from '../utils/datetime.js';
+export const greetingTool = {
+    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']
+    },
+    handler: async (args, _extra) => {
+        try {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `👋 Hello ${args.name}! Welcome to the MCP server!`
+                    }
+                ]
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error generating greeting for ${args.name}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+export const cardTool = {
+    name: 'card',
+    description: 'Draw a random card from a standard 52-card poker deck',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: []
+    },
+    handler: async (_args, _extra) => {
+        try {
+            const card = getRandomCard();
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `🎴 You drew: ${card.value} of ${card.suit}`
+                    }
+                ]
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Error drawing card from deck'
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+export const dateTimeTool = {
+    name: 'datetime',
+    description: 'Get current date and time for a specific timezone and locale',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            timeZone: {
+                type: 'string',
+                description: 'Timezone identifier (e.g., America/New_York, Europe/London, Asia/Tokyo)'
+            },
+            locale: {
+                type: 'string',
+                description: 'Locale identifier (e.g., en-US, es-ES, fr-FR)'
+            }
+        }
+    },
+    handler: async (args, _extra) => {
+        try {
+            const { date, time, timeZone } = getCurrentDateTime(args);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `🗓️ Date: ${date}\n⏰ Time: ${time}\n🌍 Timezone: ${timeZone}`
+                    }
+                ]
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Error retrieving date and time information'
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+// Export all available tools
+const availableTools = [greetingTool, cardTool, dateTimeTool];
+export default availableTools;
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,14 @@
+export interface Card {
+    value: string;
+    suit: string;
+}
+export interface ServerResponse<T> {
+    content: Array<{
+        type: string;
+        text: string;
+        data?: T;
+    }>;
+}
+export type Suit = '♠️ Spades' | '♥️ Hearts' | '♦️ Diamonds' | '♣️ Clubs';
+export type Value = 'Ace' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | 'J' | 'Q' | 'K';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC7B,OAAO,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,CAAC,CAAC;KACZ,CAAC,CAAC;CACN;AAED,MAAM,MAAM,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,GAAG,UAAU,CAAC;AAC1E,MAAM,MAAM,KAAK,GAAG,KAAK,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/utils/cards.d.ts

@@ -0,0 +1,5 @@
+import { Card, Suit, Value } from '../types/index.js';
+export declare const SUITS: Suit[];
+export declare const VALUES: Value[];
+export declare function getRandomCard(): Card;
+//# sourceMappingURL=cards.d.ts.map

package/dist/utils/cards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../../src/utils/cards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEtD,eAAO,MAAM,KAAK,EAAE,IAAI,EAA0D,CAAC;AACnF,eAAO,MAAM,MAAM,EAAE,KAAK,EAAyE,CAAC;AAEpG,wBAAgB,aAAa,IAAI,IAAI,CAQpC"}

package/dist/utils/cards.js

@@ -0,0 +1,11 @@
+export const SUITS = ['♠️ Spades', '♥️ Hearts', '♦️ Diamonds', '♣️ Clubs'];
+export const VALUES = ['Ace', '2', '3', '4', '5', '6', '7', '8', '9', '10', 'J', 'Q', 'K'];
+export function getRandomCard() {
+    const randomSuit = SUITS[Math.floor(Math.random() * SUITS.length)];
+    const randomValue = VALUES[Math.floor(Math.random() * VALUES.length)];
+    return {
+        suit: randomSuit,
+        value: randomValue
+    };
+}
+//# sourceMappingURL=cards.js.map

package/dist/utils/cards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cards.js","sourceRoot":"","sources":["../../src/utils/cards.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,KAAK,GAAW,CAAC,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;AACnF,MAAM,CAAC,MAAM,MAAM,GAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAEpG,MAAM,UAAU,aAAa;IACzB,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAEtE,OAAO;QACH,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,WAAW;KACrB,CAAC;AACN,CAAC"}

package/dist/utils/datetime.d.ts

@@ -0,0 +1,12 @@
+interface DateTimeOptions {
+    timeZone?: string;
+    locale?: string;
+}
+interface DateTimeResult {
+    date: string;
+    time: string;
+    timeZone: string;
+}
+export declare function getCurrentDateTime(options?: DateTimeOptions): DateTimeResult;
+export {};
+//# sourceMappingURL=datetime.d.ts.map

package/dist/utils/datetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../../src/utils/datetime.ts"],"names":[],"mappings":"AAAA,UAAU,eAAe;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,cAAc;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,CA4BhF"}

package/dist/utils/datetime.js

@@ -0,0 +1,23 @@
+export function getCurrentDateTime(options = {}) {
+    const { timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone, locale = 'en-US' } = options;
+    const now = new Date();
+    const dateFormatter = new Intl.DateTimeFormat(locale, {
+        timeZone,
+        year: 'numeric',
+        month: 'long',
+        day: 'numeric'
+    });
+    const timeFormatter = new Intl.DateTimeFormat(locale, {
+        timeZone,
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hour12: true
+    });
+    return {
+        date: dateFormatter.format(now),
+        time: timeFormatter.format(now),
+        timeZone
+    };
+}
+//# sourceMappingURL=datetime.js.map

package/dist/utils/datetime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.js","sourceRoot":"","sources":["../../src/utils/datetime.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,kBAAkB,CAAC,UAA2B,EAAE;IAC5D,MAAM,EACF,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ,EAC3D,MAAM,GAAG,OAAO,EACnB,GAAG,OAAO,CAAC;IAEZ,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,MAAM,aAAa,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE;QAClD,QAAQ;QACR,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,SAAS;KACjB,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE;QAClD,QAAQ;QACR,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,IAAI;KACf,CAAC,CAAC;IAEH,OAAO;QACH,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC;QAC/B,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC;QAC/B,QAAQ;KACX,CAAC;AACN,CAAC"}

package/dist/utils/schema.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export interface JsonSchemaProperty {
+    type: string;
+    description?: string;
+    [key: string]: unknown;
+}
+export interface JsonSchema {
+    type: 'object';
+    properties?: Record<string, JsonSchemaProperty>;
+    required?: string[];
+    [key: string]: unknown;
+}
+export declare class SchemaConverter {
+    private static convertProperty;
+    static toZod(schema: JsonSchema): z.ZodObject<any>;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/utils/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAC,eAAe;IAa9B,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;CAgBrD"}

package/dist/utils/schema.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export class SchemaConverter {
+    static convertProperty(prop) {
+        switch (prop.type) {
+            case 'string':
+                return prop.description ? z.string().describe(prop.description) : z.string();
+            case 'number':
+                return z.number();
+            case 'boolean':
+                return z.boolean();
+            default:
+                return z.any();
+        }
+    }
+    static toZod(schema) {
+        if (schema.type !== 'object') {
+            throw new Error('Only object schemas are supported');
+        }
+        const shape = {};
+        if (schema.properties) {
+            Object.entries(schema.properties).forEach(([key, prop]) => {
+                shape[key] = this.convertProperty(prop);
+            });
+        }
+        const zodSchema = z.object(shape);
+        return schema.required?.length ? zodSchema.required() : zodSchema;
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/utils/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,MAAM,OAAO,eAAe;IAChB,MAAM,CAAC,eAAe,CAAC,IAAwB;QACnD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAChB,KAAK,QAAQ;gBACT,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YACjF,KAAK,QAAQ;gBACT,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;YACtB,KAAK,SAAS;gBACV,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;YACvB;gBACI,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC;QACvB,CAAC;IACL,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAkB;QAC3B,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,KAAK,GAA8B,EAAE,CAAC;QAE5C,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;gBACtD,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAC5C,CAAC,CAAC,CAAC;QACP,CAAC;QAED,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClC,OAAO,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,CAAC;CACJ"}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@nekzus/mcp-server",
+  "version": "0.0.0-development",
+  "description": "Personal MCP Server implementation providing extensible utility functions and tools for development and testing purposes",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "jest --passWithNoTests",
+    "lint": "eslint . --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "commit": "git-cz",
+    "semantic-release": "semantic-release --branches main",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm test && npm run lint",
+    "preversion": "npm run lint",
+    "version": "npm run format && git add -A src",
+    "postversion": "git push && git push --tags"
+  },
+  "keywords": [
+    "mcp",
+    "server",
+    "typescript",
+    "greetings",
+    "cards",
+    "games"
+  ],
+  "author": "nekzus",
+  "license": "MIT",
+  "directories": {
+    "lib": "dist",
+    "bin": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "files": [
+      "dist",
+      "README.md",
+      "LICENSE"
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Nekzus/mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Nekzus/mcp-server/issues"
+  },
+  "homepage": "https://github.com/Nekzus/mcp-server#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.7.0",
+    "dotenv": "16.4.7",
+    "zod": "3.24.2"
+  },
+  "devDependencies": {
+    "semantic-release": "^24.2.3",
+    "cz-conventional-changelog": "3.3.0",
+    "@types/jest": "29.5.14",
+    "@types/node": "22.13.10",
+    "@typescript-eslint/eslint-plugin": "8.27.0",
+    "@typescript-eslint/parser": "8.27.0",
+    "eslint": "9.22.0",
+    "jest": "^29.7.0",
+    "prettier": "3.5.3",
+    "ts-jest": "29.2.6",
+    "tsx": "4.19.3",
+    "typescript": "5.8.2"
+  },
+  "engines": {
+    "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+  },
+  "config": {
+    "commitizen": {
+      "path": "./node_modules/cz-conventional-changelog"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}