@nekzus/mcp-server 1.0.31 → 1.0.32

package/biome.json

@@ -0,0 +1,45 @@
+{
+    "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+    "vcs": {
+        "enabled": true,
+        "clientKind": "git",
+        "useIgnoreFile": true
+    },
+    "files": {
+        "ignoreUnknown": false,
+        "ignore": []
+    },
+    "formatter": {
+        "enabled": true,
+        "formatWithErrors": false,
+        "ignore": [],
+        "indentStyle": "tab",
+        "lineEnding": "lf",
+        "lineWidth": 100
+    },
+    "organizeImports": {
+        "enabled": true
+    },
+    "linter": {
+        "enabled": true,
+        "rules": {
+            "recommended": true,
+            "style": {
+                "noNonNullAssertion": "off"
+            },
+            "suspicious": {
+                "noExplicitAny": "off"
+            }
+        }
+    },
+    "javascript": {
+        "formatter": {
+            "quoteStyle": "single"
+        }
+    },
+    "json": {
+        "formatter": {
+            "indentStyle": "space"
+        }
+    }
+}

package/index.ts

@@ -0,0 +1,210 @@
+#!/usr/bin/env node
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import type { CallToolResult, Tool } from '@modelcontextprotocol/sdk/types.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import 'dotenv/config';
+
+// Available tools definition
+const TOOLS: Tool[] = [
+	{
+		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: { name: string }): Promise<CallToolResult> {
+	const { name } = args;
+	return {
+		content: [
+			{
+				type: 'text',
+				text: `¡Hola ${name}! ¿Cómo estás?`,
+			},
+		],
+		isError: false,
+	};
+}
+
+async function handleCard(): Promise<CallToolResult> {
+	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: {
+	timeZone?: string;
+	locale?: string;
+}): Promise<CallToolResult> {
+	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: string, args: any): Promise<CallToolResult> {
+	switch (name) {
+		case 'greeting':
+			return handleGreeting(args);
+		case 'card':
+			return handleCard();
+		case 'datetime':
+			return handleDateTime(args);
+		default:
+			return {
+				content: [
+					{
+						type: 'text',
+						text: `Error: 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: {},
+		},
+	},
+);
+
+// Request handlers configuration
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+	return {
+		tools: TOOLS,
+	};
+});
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+	const { name, arguments: args } = request.params;
+	return handleToolCall(name, args ?? {});
+});
+
+// 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(', '));
+
+		// Termination signal handlers
+		process.on('SIGTERM', () => cleanup());
+		process.on('SIGINT', () => cleanup());
+
+		// 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 for server shutdown
+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();

package/package.json

@@ -1,18 +1,14 @@
 {
   "name": "@nekzus/mcp-server",
-  "version": "1.0.31",
+  "version": "1.0.32",
   "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": "./dist/index.js",
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-server": "dist/index.js"
+  },
   "scripts": {
-    "build": "tsc && shx chmod +x dist/index.js",
+    "build": "tsc && shx chmod +x dist/*.js",
     "dev": "tsx src/index.ts",
     "start": "node dist/index.js",
     "test": "jest --passWithNoTests",
@@ -22,8 +18,7 @@
     "commit": "git-cz",
     "semantic-release": "semantic-release --branches main",
     "prepare": "npm run build",
-    "watch": "tsc --watch",
-    "ci": "npm run check && npm run build && npm test"
+    "watch": "tsc --watch"
   },
   "keywords": [
     "mcp",
@@ -45,8 +40,7 @@
   "homepage": "https://github.com/Nekzus/mcp-server#readme",
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.7.0",
-    "dotenv": "16.4.7",
-    "zod": "3.24.2"
+    "dotenv": "16.4.7"
   },
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
@@ -65,9 +59,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"