时间服务服务器

一个简单的MCP服务器,提供当前日期和时间信息,确保Claude获取准确的实时数据。

  • by senseiBas
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 senseiBas/datetime-mcp-server

使用说明

日期时间mcp服务器

一个简单、专注的MCP(模型上下文协议)服务器,提供当前日期和时间信息。此服务器使Claude能够始终获得准确的当前日期/时间,而不是依赖过时的会话开始日期。

特性

  • 三个日期时间工具 对于不同的用例:

    • get_current_datetime:返回带时区的ISO 8601格式
    • get_current_date:以YYYY-MM-DD格式返回日期
    • get_formatted_datetime:返回人类可读的格式
  • 欧洲/阿姆斯特丹时区 -所有时间均为CET/CEST时区

  • 正确的错误处理 -优雅的错误管理

  • 键入提示 -完整类型注释可提高代码质量

  • 清洁实施 -简单、专注、无额外功能

安装

先决条件

  • Python 3.10或更高版本
  • pip包管理器

从源代码安装

  1. 克隆存储库:
git clone https://github.com/<ACTUAL_USERNAME_OR_ORG>/datetime-mcp-server.git
cd datetime-mcp-server
  1. 安装软件包:
pip install -e .

或者直接安装依赖项:

pip install -r requirements.txt

用法

独立运行服务器

您可以直接运行服务器来测试它:

python -m datetime_mcp_server.server

添加到Claude桌面

要将此MCP服务器与Claude Desktop一起使用,请将以下内容添加到您的Claude Desktop配置文件中:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "datetime": {
      "command": "python",
      "args": [
        "-m",
        "datetime_mcp_server.server"
      ],
      "env": {
        "PYTHONPATH": "/absolute/path/to/datetime-mcp-server/src"
      }
    }
  }
}

替换 /absolute/path/to/datetime-mcp-server/src 实际绝对路径为 src 安装中的目录。

或者,如果您在全局或虚拟环境中安装了该软件包:

{
  "mcpServers": {
    "datetime": {
      "command": "python",
      "args": [
        "-m",
        "datetime_mcp_server.server"
      ]
    }
  }
}

更新配置后,重新启动Claude Desktop。

可用工具

get_current _日期时间

返回ISO 8601格式的当前日期和时间以及时区信息。

输出示例: 2025-12-03T14:30:15.123456+01:00

get_current _日期

仅返回YYYY-MM-DD格式的当前日期。

输出示例: 2025-12-03

get_formatted_datetime

以人类可读的格式返回当前日期和时间。

输出示例: Wednesday, December 03, 2025 - 14:30:15 CET

发展

项目结构

datetime-mcp-server/
├── src/
│   └── datetime_mcp_server/
│       ├── __init__.py
│       └── server.py
├── pyproject.toml
├── requirements.txt
└── README.md

运行测试

安装开发依赖项:

pip install -e ".[dev]"

运行测试:

pytest

技术细节

  • 语言:Python 3.10+
  • 框架:MCP Python SDK
  • 时区:欧洲/阿姆斯特丹(CET/CEST)
  • 协议:模型上下文协议(MCP)

为什么选择此服务器?

Claude对当前日期/时间的了解是基于会话开始时间,在长时间对话中可能会变得过时。此MCP服务器为Claude提供了一种可靠的方式:

  • 获取当前的实际日期和时间
  • 日期格式一致
  • 使用准确的时区信息
  • 避免因过时的会话数据而产生混淆

许可证

MIT许可证-可根据需要自由使用和修改。

贡献

欢迎投稿!请随时提交拉取请求。

支持

对于问题或疑问,请在GitHub存储库上打开问题。