本地时间 MCP 服务器

一个简单而实用的 Model Context Protocol (MCP) 时间服务器，提供获取当前系统时间的功能。

特性

• 🕒 获取当前系统时间，支持自定义格式
• 📝 完整的日志记录功能
• 🔧 易于配置和使用
• 📦 支持 npx 直接运行
• 🌐 兼容 MCP 协议标准

安装

使用 npx（推荐）

无需安装，直接运行：

npx local-time-mcp-service-ysd

全局安装

npm install -g local-time-mcp-service-ysd

项目中安装

npm install local-time-mcp-service-ysd

使用方法

基本使用

启动 MCP 时间服务器：

npx local-time-mcp-service-ysd

服务器将通过标准输入输出（STDIO）监听 MCP 协议请求。

在 MCP 客户端中配置

在您的 MCP 客户端配置文件中添加以下配置：

{
  "mcpServers": {
    "time-server": {
      "command": "npx",
      "args": ["local-time-mcp-service-ysd"],
      "env": {}
    }
  }
}

或者如果您已经全局安装：

{
  "mcpServers": {
    "time-server": {
      "command": "local-time-mcp-service-ysd",
      "args": [],
      "env": {}
    }
  }
}

可用工具

getSystemTime

获取当前系统时间。

参数：

• format (可选): 时间格式字符串，默认为 YYYY-MM-DD HH:mm:ss

示例格式：

• YYYY-MM-DD HH:mm:ss → 2024-01-15 14:30:25
• YYYY/MM/DD → 2024/01/15
• HH:mm:ss → 14:30:25
• MMMM Do YYYY, h:mm:ss a → January 15th 2024, 2:30:25 pm

使用示例：

{
  "name": "getSystemTime",
  "arguments": {
    "format": "YYYY-MM-DD HH:mm:ss"
  }
}

日志功能

服务器会自动创建日志文件，记录运行状态：

• 日志文件位置：logs/mcp-time-server-YYYY-MM-DD.log
• 包含启动时间、请求记录、错误信息等
• 同时输出到控制台和文件

开发和调试

本地开发

# 克隆项目
git clone <your-repo-url>
cd local-time-mcp-service-ysd

# 安装依赖
npm install

# 运行服务器
node index.js

测试

您可以使用任何支持 MCP 协议的客户端来测试服务器功能。

技术栈

• Node.js (>= 18)
• @modelcontextprotocol/sdk - MCP 协议实现
• dayjs - 时间处理和格式化

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request！

更新日志

v1.0.0

• 初始版本
• 支持获取系统时间
• 完整的日志记录功能
• 支持自定义时间格式