Nekzus_mcp-server

🚀 MCP 服务器

MCP 服务器是一个强大的平台，集成了多种实用工具，为用户提供便捷的服务。用户可按需调用不同工具，轻松完成特定任务。

🚀 快速开始

全局安装

在终端中运行以下命令进行全局安装：

npm install -g @nekzus/mcp-server

启动服务器

安装完成后，可以通过以下命令启动 MCP 服务器：

npx @nekzus/mcp-server

✨ 主要特性

• 多工具支持：集成多种功能模块，满足不同需求
• 输入验证：使用 Zod 进行严格的输入校验
• 错误处理：具备完善的异常捕捉和资源清理机制
• 信号处理：支持 SIGTERM 和 SIGINT 信号，实现优雅关机

📦 安装指南

克隆仓库

在终端中运行以下命令克隆项目仓库：

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

安装依赖

进入项目目录后，安装所有依赖包：

npm install

开发模式

使用以下命令启动开发服务器：

npm run dev

构建项目

运行以下命令进行项目构建：

npm run build

运行服务

构建完成后，可以使用以下命令运行服务：

npm start

💻 使用示例

简单转换工具

单位换算

功能描述

提供体积和重量单位之间的互转服务，支持多种常见单位。

支持的单位

• 体积：

  • ml（毫升）
  • l（升）
  • cup（美国杯）
  • tbsp（ tablespoon）
  • tsp（ teaspoon）
  • floz（ fluid ounce）

• 重量：

  • g（克）
  • kg（千克）
  • oz（盎司）
  • lb（磅）

基础用法

// 将 1 美国杯转换为毫升
{
  "value": 1,
  "from": "cup",
  "to": "ml"
}

返回结果

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

时间格式化

功能描述

将给定的时间戳格式化为易读的字符串。

参数要求

• 时间戳：Unix 时间戳（秒或毫秒）

基础用法

// 将 Unix 时间戳 1672598400 转换为人类可读格式
{
  "timestamp": 1672598400,
  "format": "YYYY-MM-DD HH:mm:ss"
}

返回结果

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

高级工具

数据统计

功能描述

对输入数据进行基本的统计分析，包括最大值、最小值、平均值和总和。

输入要求

• data: 数组形式的数据集

基础用法

// 统计数组 [1, 2, 3, 4, 5] 的基本信息
{
  "data": [1, 2, 3, 4, 5]
}

返回结果

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

📚 详细文档

项目结构

项目的目录结构如下：

src/
├── types/          # 类型定义文件夹
│   └── index.ts    # 公共类型定义
├── utils/          # 工具函数文件夹
│   ├── cards.ts    # 卡牌相关功能
│   ├── datetime.ts # 日期时间处理
│   └── schema.ts   # 数据校验方案
├── tools/          # 各工具实现文件夹
│   └── index.ts    # 工具注册中心
└── index.ts        # 程序入口点

🔧 技术细节

• 通信协议：使用 StdioServerTransport 实现进程间通信
• 数据校验：将 JSON 校验方案转换为 Zod 模型进行校验
• 类型安全：全程采用 TypeScript 进行静态类型检查
• 错误处理：具备完善的异常捕捉和资源清理机制
• 信号处理：支持 SIGTERM 和 SIGINT 信号，实现优雅关机

📄 许可证

项目遵循 MIT 许可证协议。

📞 联系方式

如需反馈或合作，请联系：

• 邮箱：support@nekzus.com
• 官网：https://mcp.nekzus.com