Nekzus MCP Server

🚀 MCP Server

The MCP Server is a platform that offers a variety of practical tools, aiming to provide users with convenient services. Users can call different tools to complete specific tasks.

🚀 Quick Start

Global Installation

Run the following command in the terminal for global installation:

npm install -g @nekzus/mcp-server

Start the Server

After the installation is complete, you can start the MCP Server with the following command:

npx @nekzus/mcp-server

✨ Features

• Multi-tool Support: Integrates multiple functional modules to meet different needs.
• Input Validation: Uses Zod for strict input verification.
• Error Handling: Has a comprehensive mechanism for catching exceptions and cleaning up resources.
• Signal Handling: Supports SIGTERM and SIGINT signals for graceful shutdown.

📦 Tool List

Simple Conversion Tools

Unit Conversion

Function Description

Provides a service for mutual conversion between volume and weight units, supporting a variety of common units.

Supported Units

• Volume:
  • ml (milliliter)
  • l (liter)
  • cup (US cup)
  • tbsp (tablespoon)
  • tsp (teaspoon)
  • floz (fluid ounce)
• Weight:
  • g (gram)
  • kg (kilogram)
  • oz (ounce)
  • lb (pound)

Example Usage

// Convert 1 US cup to milliliters
{
  "value": 1,
  "from": "cup",
  "to": "ml"
}

Return Result

{
  "result": 236.59,
  "unit": "ml"
}

Time Formatting

Function Description

Formats a given timestamp into a human-readable string.

Parameter Requirements

• Timestamp: Unix timestamp (in seconds or milliseconds)

Example Usage

// Convert the Unix timestamp 1672598400 to a human-readable format
{
  "timestamp": 1672598400,
  "format": "YYYY-MM-DD HH:mm:ss"
}

Return Result

{
  "formattedDate": "2023-01-01 00:00:00"
}

Advanced Tools

Data Statistics

Function Description

Performs basic statistical analysis on the input data, including maximum, minimum, average, and sum.

Input Requirements

• data: A dataset in the form of an array

Example Usage

// Calculate the basic statistics of the array [1, 2, 3, 4, 5]
{
  "data": [1, 2, 3, 4, 5]
}

Return Result

{
  "maxValue": 5,
  "minValue": 1,
  "average": 3,
  "sum": 15
}

💻 Usage Examples

Basic Usage

The above examples in the tool list section demonstrate the basic usage of different tools.

📚 Documentation

Development Information

Clone the Repository

Run the following command in the terminal to clone the project repository:

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

Install Dependencies

After entering the project directory, install all the dependency packages:

npm install

Development Mode

Use the following command to start the development server:

npm run dev

Build the Project

Run the following command to build the project:

npm run build

Run the Service

After the build is complete, you can run the service with the following command:

npm start

Project Structure

The directory structure of the project is as follows:

src/
├── types/          # Folder for type definitions
│   └── index.ts    # Common type definitions
├── utils/          # Folder for utility functions
│   ├── cards.ts    # Card-related functions
│   ├── datetime.ts # Date and time processing
│   └── schema.ts   # Data validation scheme
├── tools/          # Folder for tool implementations
│   └── index.ts    # Tool registration center
└── index.ts        # Program entry point

🔧 Technical Details

• Communication Protocol: Uses StdioServerTransport to implement inter-process communication.
• Data Validation: Converts JSON validation schemes into Zod models for validation.
• Type Safety: Uses TypeScript for static type checking throughout the process.
• Error Handling: Has a comprehensive mechanism for catching exceptions and cleaning up resources.
• Signal Handling: Supports SIGTERM and SIGINT signals for graceful shutdown.

📄 License

This project follows the MIT license agreement.

Contact Information

If you need to provide feedback or cooperate, please contact us:

• Email: support@nekzus.com
• Official Website: https://mcp.nekzus.com