Whenny MCP 服务器

关键词

JSON-RPCAI 集成时间与时区日期工具服务器端

使用说明

  • 项目简介 Whenny 的 MCP 服务器实现提供了将日期与时间相关功能（格式化、相对时间、比较、持续时间、时区转换等）通过 MCP 客户端请求暴露出来的服务器端能力。服务器以 MCP 的 JSON-RPC 风格接收请求，返回相应结果或通知。

  • 主要功能点

    • 解析并处理 MCP 请求与响应，遵循 MCP 的核心通信模式（JSON-RPC 风格请求/响应格式）。
    • 提供可注册的工具集合（如 whenny、format_datewind、format_relative、compare_dates、calendar_check、duration 等），并支持执行工具请求。
    • 支持初始能力探测（initialize）、列出可用工具（tools/list）、调用工具（tools/call）等基础操作。
    • 通过服务器端逻辑将日期库的功能暴露给 AI 客户端，便于在对话中调用日期相关功能。
    • 具备基本的错误处理与异常包装，返回规范的 MCP 风格响应。

  • 安装与运行

    • 进入包含 MCP 服务实现的包目录（Whenny 的 MCP 服务端模块）。
    • 安装依赖并构建：
      • 安装依赖并编译源代码，以确保 mcp 服务能够以 Node 进程形式运行。
    • 启动服务：
      • 直接通过提供的命令行入口启动 MCP 服务，或通过集成脚本在服务器中以子进程方式运行。
    • 启动后，服务将通过标准输入输出（I/O）接收 MCP 客户端的 JSON-RPC 请求，并按 MCP 协议返回结果。

  • 服务器配置（MCP 客户端需的连接信息，JSON 配置示例说明）

    • server 名称: whenny
    • 启动命令与参数示例（MCP 客户端的配置格式，用于指示如何启动 MCP 服务器）：
    • 配置示例（JSON）: { "mcpServers": { "whenny": { "command": "npx", "args": ["whenny", "mcp"] } // 说明：以上配置用于指示 MCP 客户端如何启动 Whenny 的 MCP 服务端。 } } 说明：该配置用于 MCP 客户端在启动时知道如何启动服务器进程、以及如何通过命令和参数与 MCP 服务建立对话。MCP 客户端本身不需要理解服务器内部实现细节，只需要知道启动命令与参数即可建立连接。

  • 基本使用方法

    1. 启动服务器后，MCP 客户端可以向服务器发送初始化请求以建立能力清单与会话信息。
    2. 使用工具相关的请求（如列出工具、调用指定工具）进行意图驱动的对话交互。
    3. 客户端可发送传输请求以获取带时区上下文的时间数据，并在对话中进行时间计算、格式化等操作。
    4. 服务器返回标准的 JSON-RPC 响应，客户端据此进行后续处理与展示。

  • 额外信息

    • 服务器实现具备对工具的注册与执行能力，能够将 Whenny 库中的多种功能暴露给 AI 客户端，例如日期格式化、相对时间、日历检查、时区转换等。
    • 与客户端的通信遵循 JSON-RPC 的请求/响应模式，方便与现有的 MCP 客户端对接。
    • 提供了基本的错误处理与工具执行封装，确保在调用失败时能够返回清晰的错误信息。

服务器信息

访问项目