JinDaGe - mcp-datetime MCP Details

article

README

🚀 mcp-datetime

mcp-datetime 是一个专门处理日期时间格式化的 MCP 服务器。它支持多种日期时间格式，还能通过配置与 Claude Desktop 应用集成，为日期时间处理提供了高效且灵活的解决方案。

🚀 快速开始

在 Claude Desktop 应用中使用 mcp-datetime，需将以下内容添加到配置文件：

{
  "mcpServers": {
    "datetime": {
      "command": "uvx",
      "args": ["mcp-datetime"]
    }
  }
}

✨ 主要特性

支持多种日期时间格式化输出，满足不同场景需求。
提供日语语言支持，拓展了使用范围。
可与 Claude Desktop 应用无缝集成，提升使用便利性。
具备高效的性能表现，适合处理大量请求。

📦 安装指南

安装前的准备

Python 版本：要求 Python 3.12 或更高版本。
工具依赖：
- uv：一个用于处理异步编程的库。
- uvx：用于运行 MCP 服务器的工具。

安装方式

方式一：使用 PyPI 包

pip install mcp-datetime

方式二：使用 GitHub 源码

git clone https://github.com/ZeparHyfar/mcp-datetime.git
cd mcp-datetime
uvx install

方式三：手动安装

下载源代码后，执行以下命令：

uvx run mcp-datetime --install

💻 使用示例

基础用法

调用服务

uvx invoke mcp-datetime get_datetime --format iso
# 输出结果示例：
2024-12-10T00:54:01+0900

在 Claude Desktop 中使用

const datetime = await invoke('mcp-datetime', 'get_datetime', {
  format: 'filename_log'
});
// 输出结果示例：
2024-12-10_005401.log

📚 详细文档

MCP 服务器组件

工具说明

命令：get_datetime
参数：
- format：指定输出格式（可选，默认为 ISO 格式）。
返回值：基于指定格式的日期时间字符串。

支持的格式

| 属性 | 详情 | |------|------| | 紧凑型格式（compact） | 示例输出：20241210005401，适合用作标识符。 | | ISO 8601 标准格式（iso） | 示例输出：2024-12-10T00:54:01+0900。 | | 带微秒的日志格式（log） | 示例输出：2024-12-10 00:54:01.123456。 | | 日志文件名格式（filename_log） | 示例输出：2024-12-10_005401.log。 |

调试指南

由于 MCP 服务器通过标准输入输出运行，调试较为困难。我们推荐使用 MCP Inspector 工具：

npx @modelcontextprotocol/inspector uvx mcp-datetime

📄 许可证

本项目采用 MIT License 开源协议，具体条款详见 LICENSE 文件。

mcp-datetime