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