Nekzus MCP 服务器

<div align="center">

一个模型上下文协议 (MCP) 服务器，提供用于开发和测试的实用工具 </br>此实现构建在官方 MCP SDK 之上，并提供可扩展的架构以添加新工具

</div>

组件

工具

• greeting

  • 生成个性化的问候消息
  • 输入: name (字符串, 必需): 收件人的姓名
  • 示例:

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

• card

  • 从标准的 52 张牌的扑克牌组中抽取随机牌
  • 输入: 无需参数
  • 示例:

    {} -> "🎴 Drew card: A♠️" (从 52 张牌中随机抽取)
    

• datetime

  • 获取任何时区的格式化日期/时间
  • 输入:
    • timeZone (字符串, 可选, 默认: "UTC"): 时区标识符
    • locale (字符串, 可选, 默认: "en-US"): 格式化区域设置
  • 示例:

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

• calculator

  • 执行数学计算
  • 输入:
    • expression (字符串, 必需): 要计算的数学表达式
    • precision (数字, 可选, 默认: 2): 小数位数
  • 支持的运算: +, -, *, /, %, (), .
  • 示例:

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

• passwordGen

  • 生成具有可自定义选项的安全密码
  • 输入:
    • length (数字, 可选, 默认: 16): 密码长度
    • includeNumbers (布尔值, 可选, 默认: true): 包含数字
    • includeSymbols (布尔值, 可选, 默认: true): 包含特殊符号
    • includeUppercase (布尔值, 可选, 默认: true): 包含大写字母
  • 示例:

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

• qrGen

  • 为文本或 URL 生成 QR 码
  • 输入:
    • text (字符串, 必需): 要编码的文本或 URL
    • size (数字, 可选, 默认: 200): 像素大小
    • dark (字符串, 可选, 默认: "#000000"): 深色模块的颜色
    • light (字符串, 可选, 默认: "#ffffff"): 浅色模块的颜色
  • 输出: 返回包含 QR 码图像的 Data URL
  • 示例:

    // 基本用法
    {"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,..."
    
    // 自定义大小和颜色
    {
      "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,..."
    

  注意: QR 码作为 Data URL 返回，可以直接在 HTML <img> 标签中使用或转换为文件。

• kitchenConvert

  • 在厨房测量单位之间进行转换
  • 输入:
    • value (数字, 必需): 要转换的值
    • from (字符串, 必需): 源单位
    • to (字符串, 必需): 目标单位
    • ingredient (字符串, 可选): 用于精确转换的配料

  支持的单位:

  体积单位:

  - ml    (毫升)
  - l     (升)
  - cup   (美制杯 = 236.588 毫升)
  - tbsp  (美制汤匙 = 14.787 毫升)
  - tsp   (美制茶匙 = 4.929 毫升)
  - floz  (美制液体盎司 = 29.574 毫升)
  

  重量单位:

  - g     (克)
  - kg    (千克)
  - oz    (盎司 = 28.350 克)
  - lb    (磅 = 453.592 克)
  

  配料密度:

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

  示例:

  // 体积到体积
  {"value": 1, "from": "cup", "to": "ml"} -> 
  "⚖️ 1 cup = 236.59 ml"
  
  // 重量到重量
  {"value": 500, "from": "g", "to": "lb"} -> 
  "⚖️ 500 g = 1.10 lb"
  
  // 体积到重量 (需要配料)
  {"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

开发

# 安装依赖
npm install

# 在开发模式下运行
npm run dev

# 格式化代码
npm run format

# 检查代码风格
npm run lint

# 运行测试
npm run test

# 构建
npm run build

Docker

构建 Docker 镜像：

# 构建镜像
docker build -t nekzus/mcp-server .

# 运行容器
docker run -i --rm --init nekzus/mcp-server

贡献

1. Fork 仓库
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

表达你的支持

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