时间服务工具

一个轻量级的MCP服务器,提供返回当前时间的单一工具,用于测试MCP连接或学习MCP服务器实现。

  • by bokuhe
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 bokuhe/time-mcp

使用说明

Time MCP 可以翻译为“时间MCP”或根据上下文具体含义调整,但通常“MCP”可能代表某个特定的概念或缩写,如果没有具体上下文,直接翻译为“时间MCP”即可。如果“MCP”有特定含义,比如“主控程序”(Master Control Program)等,则需要根据具体情境来翻译。在缺乏具体上下文的情况下,“时间MCP”是一个较为通用的翻译

这是一个最简单的轻量级项目,用于测试MCP(模型上下文协议)连接。

概述

这是一个提供返回当前时间的单一工具的最小MCP服务器。可用于学习MCP服务器的实现方法或测试MCP连接。

安装

pnpm install

执行

带有Node.js的环境

# 개발 모드 (TypeScript 직접 실행)
npm run dev

# 빌드 후 실행
npm run build
npm start

没有Node.js的环境(独立可执行文件)

构建执行文件:

npm run build:exe

构建的文件:

  • build/time-mcp-linux (Linux x64)
  • build/time-mcp-macos (macOS x64) 翻译为中文是:(适用于macOS的64位系统)
  • build/time-mcp-win.exe (Windows x64) 翻译为中文是:(Windows 64位版)

执行:

# Linux/macOS
./build/time-mcp-linux

# Windows
build\time-mcp-win.exe

提供的工具

get_current_time

返回当前日期和时间的ISO 8601格式。

  • 输入参数:无
  • 输出ISO格式的当前时间(例如: 2025-10-10T13:30:00.000Z)

在MCP客户端中使用

此服务器通过stdio进行通信,因此可以在MCP客户端设置中进行如下配置:

Node.js 版本:

{
  "mcpServers": {
    "time-mcp": {
      "command": "node",
      "args": ["/path/to/time-mcp/dist/index.js"]
    }
  }
}

独立可执行文件版本:

{
  "mcpServers": {
    "time-mcp": {
      "command": "/path/to/time-mcp/build/time-mcp-linux"
    }
  }
}

项目结构

  • src/index.tsMCP服务器全实现(约60行)
  • dist/TypeScript 编译结果
  • tsconfig.jsonTypeScript 配置
  • package.json项目元数据及依赖项

技术栈

  • Node.js
  • TypeScript
  • @modelcontextprotocol/sdk用于实现MCP服务器的官方SDK
  • tsx用于直接运行TypeScript的开发工具
  • esbuild捆绑(软件包/服务等)
  • pkg生成可执行文件