时间服务工具

MCP时间服务器提供全面的时间相关工具和实用程序,包括获取当前时间、时区转换、Unix时间戳转换等功能。

  • by asishjagana
  • C#
  • 本地部署
  • 更新于
在 GitHub 查看 asishjagana/McpServer

使用说明

MCP时间服务器

一种模型上下文协议(MCP)服务器,提供全面的时间相关工具和实用程序。

特性

  • 当前时间:获取当前本地时间
  • 时区支持:获取特定时区的时间
  • 时区转换:在不同时区之间转换时间
  • 可用时区:列出所有可用的系统时区
  • Unix时间戳:转换为Unix时间戳或从Unix时间戳转换
  • 多种格式:以各种标准格式获取时间

可用工具

1.电流

获取当前本地时间。

用途:

{
  "name": "GetCurrentTime",
  "arguments": {}
}

2.GetTimeInTimezone

获取特定时区的当前时间。

参数:

  • timezone (string):时区ID(例如,“东部标准时间”、“UTC”)

用途:

{
  "name": "GetTimeInTimezone",
  "arguments": {
    "timezone": "UTC"
  }
}

3.获取可用时区

返回可用系统时区列表(仅限于前50个)。

用途:

{
  "name": "GetAvailableTimezones",
  "arguments": {}
}

4.转换时区之间的时间

将时间从一个时区转换为另一个时区。

参数:

  • sourceTimezone (string):源时区ID
  • targetTimezone (string):目标时区ID
  • timeToConvert (字符串,可选):转换为“yyyy-MM-dd HH:MM:ss”格式的时间

用途:

{
  "name": "ConvertTimeBetweenTimezones",
  "arguments": {
    "sourceTimezone": "UTC",
    "targetTimezone": "Eastern Standard Time",
    "timeToConvert": "2024-01-15 14:30:00"
  }
}

5.GetUnixTimestamp

获取当前Unix时间戳。

用途:

{
  "name": "GetUnixTimestamp",
  "arguments": {}
}

6.ConvertUnixTimestamp

将Unix时间戳转换为可读时间。

参数:

  • timestamp (long):要转换的Unix时间戳

用途:

{
  "name": "ConvertUnixTimestamp",
  "arguments": {
    "timestamp": 1705310400
  }
}

7. GetTimeInFormats

获取多种标准格式的当前时间。

用途:

{
  "name": "GetTimeInFormats",
  "arguments": {}
}

设置和安装

先决条件

  • .NET 10.0或更高版本
  • ModelContextProtocol包

构建服务器

dotnet build

运行服务器

dotnet run

服务器将开始使用stdio传输,这是MCP服务器的标准。

配置

服务器已在中配置 Program.cs:

  • 使用stdio传输进行通信
  • 自动从部件中发现工具
  • 与Microsoft一起构建。扩展。托管以实现稳健的生命周期管理

通用时区ID

以下是一些常用的时区ID:

  • UTC -协调世界时
  • Eastern Standard Time -美国东部时间
  • Central Standard Time -美国中部时间
  • Mountain Standard Time -美国山地时间
  • Pacific Standard Time -美国太平洋时间
  • GMT Standard Time -格林尼治标准时间
  • Central European Standard Time -中欧时间
  • Tokyo Standard Time -日本标准时间

使用 GetAvailableTimezones 查看系统上所有可用时区的工具。

错误处理

服务器包括全面的错误处理:

  • 无效的时区ID返回有用的错误消息
  • 捕获并报告无效的时间格式
  • 所有异常都会被捕获并作为错误消息返回

与MCP客户端集成

此服务器可以与任何兼容MCP的客户端集成,例如:

  • 克劳德桌面
  • 其他支持MCP的AI助手
  • 自定义MCP客户端应用程序

服务器通过标准MCP协议公开其工具,使发现和使用可用的时间相关功能变得容易。