Chronos MCP 服务器

一个实现了模型上下文协议 (MCP) 的时间相关服务器。此服务器通过一个简单的 MCP 接口提供时区感知的日期和时间信息。

概述

Chronos MCP 服务器使用 .NET Core 和模型上下文协议 C# SDK (github.com/modelcontextprotocol/csharp-sdk) 构建。它提供了在不同时区访问日期和时间信息的工具。该服务器设计轻量级，并演示了如何创建一个具有实用功能的自定义 MCP 服务器。它可以直接部署在机器上，也可以作为 Docker 容器部署。

特性

• 获取任何支持时区的当前日期和时间
• 通过 appsettings.json 和环境变量进行默认时区配置
• 对无效时区请求进行适当的错误处理

快速入门

前提条件

• .NET 9.0（用于本地开发/部署）
• Docker（用于容器部署）

构建说明（用于开发）

如果要从源代码构建项目：

1. 克隆此存储库：

   git clone https://github.com/aadversteeg/chronos-mcp-server.git
   

2. 导航到项目根目录：

   cd chronos-mcp-server
   

3. 使用以下命令构建项目：

   dotnet build src/chronos.sln
   

4. 运行测试：

   dotnet test src/chronos.sln
   

Docker 支持

DockerHub 镜像

Chronos MCP 服务器在 DockerHub 上可用，地址为 aadversteeg/chronos-mcp-server。

# 拉取最新版本
docker pull aadversteeg/chronos-mcp-server:latest

# 或者拉取特定版本
docker pull aadversteeg/chronos-mcp-server:0.0.1

手动 Docker 构建

如果需要自己构建 Docker 镜像：

# 导航到存储库根目录
cd chronos-mcp-server

# 构建 Docker 镜像
docker build -f src/Core.Infrastructure.McpServer/Dockerfile -t chronos-mcp-server:latest src/

# 运行本地构建的镜像
docker run -d --name chronos-mcp -e "DefaultTimeZoneId=UTC" chronos-mcp-server:latest

使用 GitHub Actions 自动构建

此存储库包含一个 GitHub Actions 工作流程，该工作流程在创建版本标签时自动构建 Docker 镜像并将其推送到 DockerHub。

要触发新的构建：

1. 创建并推送带有语义版本的标签：

   git tag 1.0.0
   git push origin 1.0.0
   

2. 工作流程将自动构建并推送带有以下标签的 Docker 镜像：

   • aadversteeg/chronos-mcp-server:latest
   • aadversteeg/chronos-mcp-server:1.0.0

MCP 协议用法

客户端集成

要从您的应用程序连接到 Chronos MCP 服务器：

1. 使用模型上下文协议 C# SDK 或任何 MCP 兼容的客户端
2. 配置您的客户端以连接到服务器的端点
3. 调用下面描述的可用工具

可用工具

get_current_date_and_time

获取指定时区或默认时区的当前日期和时间。

参数：

• timezoneId（可选）：时区标识符（例如，“America/New_York”，“Eastern Standard Time”）。

示例请求：

{
  "name": "get_current_date_and_time",
  "parameters": {
    "timezoneId": "Europe/London"
  }
}

示例响应：

{
  "date": "2023-12-25",
  "time": "12:00:00",
  "timezone": "Europe/London"
}

get_default_timezone_id

获取为服务器配置的默认时区标识符。

示例请求：

{
  "name": "get_default_timezone_id",
  "parameters": {}
}

示例响应：

UTC

配置

DefaultTimeZoneId

DefaultTimeZoneId 设置确定在未请求特定时区时使用的时区。此值必须是操作系统识别的有效时区标识符。

您可以通过两种方式设置 DefaultTimeZoneId：

1. appsettings.json 文件（用于本地部署）：

{
  "DefaultTimeZoneId": "America/New_York"
}

2. 环境变量（用于容器化部署）：

# 运行 Docker 容器时
docker run -e "DefaultTimeZoneId=Europe/Amsterdam" aadversteeg/chronos-mcp-server:latest

有效的时区标识符包括：

• 标准 IANA 时区名称（例如，“America/New_York”，“Europe/London”，“Asia/Tokyo”）
• Windows 时区 ID（例如，“Eastern Standard Time”，“W. Europe Standard Time”）

如果未指定，服务器默认为“UTC”。

配置 Claude Desktop

使用本地安装

要配置 Claude Desktop 以使用本地安装的 Chronos 服务器：

1. 将服务器配置添加到 Claude Desktop 配置中的 mcpServers 部分：

"chronos": {
  "command": "dotnet",
  "args": [
    "YOUR_PATH_TO_DLL\\Core.Infrastructure.McpServer.dll"
  ],
  "env": {
    "DefaultTimeZoneId": "Europe/Amsterdam"
  }
}

2. 保存文件并重启 Claude Desktop

使用 Docker 容器

要从 Docker 容器中使用 Chronos 服务器与 Claude Desktop：

1. 将服务器配置添加到 Claude Desktop 配置中的 mcpServers 部分：

"chronos": {
  "command": "docker",
  "args": [
    "run",
    "--rm",
    "-i",
    "-e", "DefaultTimeZoneId=Europe/Amsterdam",
    "aadversteeg/chronos-mcp-server:latest"
  ]
}

2. 保存文件并重启 Claude Desktop

许可证

此项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。