使用说明

项目简介

Datetime MCP Server 是一个实现了 Model Context Protocol (MCP) 的简单服务器,它通过提供 'get_current_datetime' 工具,让大型语言模型(LLM)能够获取运行服务器的系统的当前日期和时间。

主要功能点

  • 提供当前日期和时间: 通过 'get_current_datetime' 工具,LLM 客户端可以获取服务器的当前日期和时间,格式为 ISO 8601 字符串。
  • 工具化能力: 以 MCP 工具的形式提供日期时间信息,方便 LLM 客户端以标准化的方式调用。

安装步骤

方式一:从 NPM 安装 (推荐)

  1. 确保已安装 Node.js 和 npm。
  2. 打开终端,运行以下命令全局安装 '@pinkpixel/datetime-mcp':
    npm install -g @pinkpixel/datetime-mcp

方式二:本地开发安装

  1. 克隆仓库到本地:
    git clone https://github.com/pinkpixel-dev/datetime-mcp.git
    cd datetime-mcp
  2. 安装依赖:
    npm install
  3. 构建项目:
    npm run build

服务器配置

将以下配置添加到您的 MCP 客户端的设置文件中,以启用 Datetime MCP Server。

NPM 安装配置:

{
  "mcpServers": {
    "datetime": {
      "command": "npx",
      "args": [
        "-y",
        "@pinkpixel/datetime-mcp"
      ],
      "disabled": false,
      "alwaysAllow": [
        "get_current_datetime"
      ]
    }
  }
}

本地开发安装配置:

请将 '/path/to/datetime-mcp' 替换为实际仓库的绝对路径。

{
  "mcpServers": {
    "datetime-local": {
      "command": "node",
      "args": ["/path/to/datetime-mcp/build/index.js"],
      "disabled": false,
      "alwaysAllow": [
        "get_current_datetime"
      ]
    }
  }
}

配置参数说明:

  • 'server name': 服务器名称,例如 'datetime' 或 'datetime-local',客户端用此名称引用服务器。
  • 'command': 启动服务器的命令,'npx' 用于 NPM 全局安装版本, 'node' 用于本地开发版本。
  • 'args': 命令参数,指定要执行的具体程序。
  • 'disabled': 设置为 'false' 启用服务器。
  • 'alwaysAllow': 允许客户端始终调用的工具列表,此处配置 'get_current_datetime' 允许客户端免鉴权调用日期时间工具。

配置完成后,重启您的 MCP 客户端应用程序以加载新的服务器配置。

基本使用方法

Datetime MCP Server 启动后,MCP 客户端可以通过以下方式使用 'get_current_datetime' 工具:

  1. 在 LLM 交互中,当需要当前日期和时间信息时,客户端可以调用 'get_current_datetime' 工具。
  2. 服务器将返回包含当前日期和时间的文本内容。
  3. LLM 可以利用返回的日期时间信息进行后续的对话或任务处理。

示例:

假设客户端发送请求调用 'get_current_datetime' 工具,服务器可能会返回如下内容:

{
  "content": [
    {
      "type": "text",
      "text": "The current date and time is: 2024-01-01T12:00:00.000Z"
    }
  ]
}

客户端解析此响应,即可获得服务器的当前日期和时间。

信息

分类

AI与计算