DateTime MCP Server

DateTime MCP Server

site icon
2025.03.03 0
Python日期时间服务笔记管理开发效率日程管理
DateTime MCP Server 是一个基于 MCP(Model Completions Protocol)协议的服务器,提供日期时间功能和简单的笔记管理功能。它支持多种日期时间格式的获取和转换,以及事件调度和笔记管理,适用于需要时间管理和简单笔记功能的开发场景。
View on GitHub

Overview

基本能力

产品定位

DateTime MCP Server 是一个基于 MCP 协议的服务器,主要用于提供日期时间相关的功能和简单的笔记管理功能。

核心功能

  1. 日期时间功能
  2. 获取当前日期和时间(多种格式)。
  3. 日期格式化工具。
  4. 事件调度提示。
  5. 笔记管理功能
  6. 添加和管理用户创建的笔记。

适用场景

  1. 需要获取或格式化日期时间的应用程序。
  2. 需要简单笔记管理功能的开发项目。
  3. 事件调度和时间管理的自动化工具。

工具列表

  1. add-note:添加新笔记,包含名称和内容。
  2. get-current-time:获取当前时间(支持 ISO、可读格式、Unix 时间戳、RFC3339)。
  3. format-date:根据指定格式模式格式化日期字符串。

常见问题解答

  1. 调试问题:由于 MCP 服务器通过 stdio 运行,调试可能较为复杂。推荐使用 MCP Inspector 进行调试。
  2. 依赖管理:使用 uv 工具管理依赖,支持生产和开发依赖的安装和同步。

使用教程

使用依赖

  1. 克隆仓库:
git clone https://github.com/bossjones/datetime-mcp-server.git
cd datetime-mcp-server
  1. 创建虚拟环境:
uv venv
source .venv/bin/activate
  1. 安装依赖:
uv sync

安装教程

  1. 运行服务器:
uv run python -m datetime_mcp_server.server
  1. 使用 MCP 客户端连接服务器:
uv run mcp connect datetime-mcp-server

调试方式

  1. 使用 MCP Inspector 调试:
npx @modelcontextprotocol/inspector uv --directory /Users/malcolm/dev/bossjones/datetime-mcp-server run datetime-mcp-server
  1. 运行测试:
uv run pytest tests/

许可证

该项目遵循 MIT 开源许可条款。