Nekzus MCP 服务器

一个提供开发和测试工具的模型上下文协议（MCP）服务器 该实现基于官方MCP SDK，并提供了一个可扩展的架构以添加新工具

组件

工具

• greeting

  • Generate personalized greeting messages
  • Input: name (string, required): Name of the recipient
  • Example:

    {"name": "John"} -> "👋 Hello John! Welcome to the MCP server!"
    

• card

  • Draw random cards from a standard 52-card poker deck
  • Input: No parameters required
  • Example:

    {} -> "🎴 Drew card: A♠️" (random from 52 cards)
    

• datetime

  • Get formatted date/time for any timezone
  • Inputs:
    • timeZone (string, optional, default: "UTC"): Timezone identifier
    • locale (string, optional, default: "en-US"): Locale for formatting
  • Example:

    {"timeZone": "America/New_York", "locale": "es-ES"} -> 
    "🕒 domingo, 24 de marzo de 2024, 15:25:25 hora de verano del este"
    

• calculator

  • Perform mathematical calculations
  • Inputs:
    • expression (string, required): Mathematical expression to evaluate
    • precision (number, optional, default: 2): Number of decimal places
  • Supported operations: +, -, *, /, %, (), .
  • Example:

    {"expression": "2 + 2 * 3", "precision": 2} -> "🔢 Result: 8.00"
    {"expression": "(15 / 2) % 2", "precision": 3} -> "🔢 Result: 1.500"
    

• passwordGen

  • Generate secure passwords with customizable options
  • Inputs:
    • length (number, optional, default: 16): Password length
    • includeNumbers (boolean, optional, default: true): Include numbers
    • includeSymbols (boolean, optional, default: true): Include special symbols
    • includeUppercase (boolean, optional, default: true): Include uppercase letters
  • Example:

    {"length": 12, "includeSymbols": true} -> "🔐 Generated: Kj2$mP9&vN4x"
    {"length": 8, "includeNumbers": false} -> "🔐 Generated: KjMpNvXw"
    

• qrGen

  • Generate QR codes for text or URLs
  • Inputs:
    • text (string, required): Text or URL to encode
    • size (number, optional, default: 200): Size in pixels
    • dark (string, optional, default: "#000000"): Color for dark modules
    • light (string, optional, default: "#ffffff"): Color for light modules
  • Output: Returns a Data URL containing the QR code image
  • Example:

    // Basic Usage
    {"text": "https://github.com/nekzus"} -> 
    "📱 QR Code generated successfully!
     Properties:
     • Content: https://github.com/nekzus
     • Size: 200px
     • Dark Color: #000000
     • Light Color: #ffffff
    
     QR Code (Data URL):
     data:image/png;base64,..."
    
    // Custom Size and Colors
    {
      "text": "Hello World!",
      "size": 300,
      "dark": "#FF0000",
      "light": "#FFFFFF"
    } -> 
    "📱 QR Code generated successfully!
     Properties:
     • Content: Hello World!
     • Size: 300px
     • Dark Color: #FF0000
     • Light Color: #FFFFFF
    
     QR Code (Data URL):
     data:image/png;base64,..."
    

  Note: The QR code is returned as a Data URL that can be used directly in HTML <img> tags or converted to a file.

• kitchenConvert

  • Convert between kitchen measurements
  • Inputs:
    • value (number, required): Value to convert
    • from (string, required): Source unit
    • to (string, required): Target unit
    • ingredient (string, optional): Ingredient for accurate conversion

  Supported Units:

  Volume Units:

  - ml    (milliliters)
  - l     (liters)
  - cup   (US cup = 236.588 ml)
  - tbsp  (US tablespoon = 14.787 ml)
  - tsp   (US teaspoon = 4.929 ml)
  - floz  (US fluid ounce = 29.574 ml)
  

  Weight Units:

  - g     (grams)
  - kg    (kilograms)
  - oz    (ounces = 28.350 g)
  - lb    (pounds = 453.592 g)
  

  Ingredient Densities:

  - water        (1.000 g/ml)
  - milk         (1.030 g/ml)
  - flour        (0.593 g/ml)
  - sugar        (0.845 g/ml)
  - brown_sugar  (0.721 g/ml)
  - salt         (1.217 g/ml)
  - butter       (0.911 g/ml)
  - oil          (0.918 g/ml)
  - honey        (1.420 g/ml)
  - maple_syrup  (1.370 g/ml)
  

  Examples:

  // Volume to Volume
  {"value": 1, "from": "cup", "to": "ml"} -> 
  "⚖️ 1 cup = 236.59 ml"
  
  // Weight to Weight
  {"value": 500, "from": "g", "to": "lb"} -> 
  "⚖️ 500 g = 1.10 lb"
  
  // Volume to Weight (requires ingredient)
  {"value": 1, "from": "cup", "to": "g", "ingredient": "flour"} -> 
  "⚖️ 1 cup of flour = 140.30 g"
  

主要特性

• 无需配置
• 符合 JSON-RPC 2.0 标准
• 类型安全的实现
• 增强了表情符号的响应
• 全面的错误处理
• ESM 支持
• 完整的 TypeScript 类型
• Docker 支持

配置

要将此服务器与 Claude Desktop 应用程序一起使用，请在 claude_desktop_config.json 的 "mcpServers" 部分添加以下配置：

NPX（推荐）

{
  "mcpServers": {
    "nekzus": {
      "transport": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@nekzus/mcp-server"
      ]
    }
  }
}

Docker

{
  "mcpServers": {
    "nekzus": {
      "transport": "stdio",
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "nekzus/mcp-server"]
    }
  }
}

配置文件通常位于：

• Windows: %APPDATA%/claude-desktop/claude_desktop_config.json
• macOS: ~/Library/Application Support/claude-desktop/claude_desktop_config.json
• Linux: ~/.config/claude-desktop/claude_desktop_config.json

开发

# Install dependencies
npm install

# Run in development mode
npm run dev

# Format code
npm run format

# Lint code
npm run lint

# Run tests
npm run test

# Build
npm run build

Docker

构建 Docker 镜像：

# Build the image
docker build -t nekzus/mcp-server .

# Run the container
docker run -i --rm --init nekzus/mcp-server

贡献

1. 叉取仓库
2. 创建你的功能分支 (git checkout -b feature/amazing-feature)
3. 使用 commitizen 提交更改 (npm run commit)
4. 将更改推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

该 MCP 服务器采用 MIT 许可证。这意味着你可以在遵守 MIT 许可证条款和条件的前提下自由地使用、修改和分发软件。更多详情，请参阅项目仓库中的 LICENSE 文件。

作者

👤 nekzus

• GitHub: @Nekzus

支持我们

如果这个项目对你有帮助，请给它一个 ⭐️！