AI导哈

时间服务工具

MCP时间服务器提供多种时间相关功能，支持本地Stdio和远程HTTP两种连接方式，适用于需要时间处理的LLM应用。

  • by mcpcentral-io
  • JavaScript
  • 混合部署
  • 3 星标
  • 更新于
在 GitHub 查看 mcpcentral-io/mcp-time

使用说明

MCP时间服务器

一个提供时间相关工具的模型上下文协议（MCP）服务器 双模式支持：

  • 标准I/O传输 对于本地的MCP客户端（通过npm）
  • 可流式传输的HTTP传输 用于远程访问（通过 Cloudflare Workers）

这台服务器允许大型语言模型（LLMs）通过多种连接方式访问各种日期/时间函数。

MCP中央服务器卡：https://guide-gen.mcpcentral.io/servers/io-github-mcpcentral-io-mcp-time

特点/特性

提供以下MCP工具：

  • current_time获取当前日期和时间，并以指定的格式和时区进行显示。
  • relative_time获取一个可读的相对时间字符串（例如，“5分钟后”，“2小时前”）。
  • days_in_month获取特定月份的天数。
  • get_timestamp获取给定时间的Unix时间戳（毫秒）。
  • convert_time在不同的IANA时区之间转换时间。
  • get_week_year获取给定日期的周数和ISO周数。

项目结构

mcp-time/
├── src/
│   └── index.ts      # Cloudflare Worker entry point & MCP logic
├── package.json      # Project dependencies and scripts
├── tsconfig.json     # TypeScript configuration
└── wrangler.toml     # Cloudflare Worker configuration

安装

选项1：通过npm安装（标准输入输出模式）

全局安装该包或使用 npx 来运行：

# Global installation
npm install -g @mcpcentral/mcp-time

# Or use directly with npx
npx @mcpcentral/mcp-time

选项2：使用远程服务器（HTTP模式）

直接连接到已部署的 Cloudflare Worker：

示例：

https://mcp.time.mcpcentral.io

使用方法

标准I/O传输（本地）

配置您的MCP客户端（例如，Claude Desktop）以使用stdio传输方式：

{
  "mcpServers": {
    "time-server": {
      "command": "npx",
      "args": ["@mcpcentral/mcp-time"]
    }
  }
}

或者使用全局安装：

{
  "mcpServers": {
    "time-server": {
      "command": "/path/to/node/bin/mcp-time"
    }
  }
}

可流式传输的HTTP传输（远程）

配置您的MCP客户端以使用远程HTTP终端：

{
  "mcpServers": {
    "time-server": {
      "url": "https://mcp.time.mcpcentral.io",
      "transport": "streamable-http"
    }
  }
}

发展

  1. 克隆仓库：

    git clone https://github.com/mcpcentral-io/mcp-time.git
cd mcp-time

  2. 安装依赖项：

    npm install

  3. 构建： 编译TypeScript代码：

    npm run build

    (这个可以编译 src/index.ts to dist/index.js)

  4. 本地测试：

    测试工作室模式：

    echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | node dist/index.js

    测试HTTP模式（通过Wrangler）：

    npx wrangler dev

    这将启动服务器 http://localhost:8787然后，您可以使用curl进行测试，或者将您的MCP客户端指向这个本地端点。

部署

部署到 Cloudflare Workers（HTTP 模式）

  1. 配置Cloudflare：

    cp wrangler.toml.example wrangler.toml

    编辑 wrangler.toml 配置您的域名（可选）。

  2. 登录并部署：

    wrangler login
npx wrangler deploy

发布到npm（标准输入输出模式）

  1. 构建软件包：

    npm run build

  2. 发布：

    npm publish --access public

适用于可流式传输的HTTP服务器的连接器

新主要服务提供商已采用模型上下文协议，并现在直接支持可流式传输的HTTP服务器。Anthropic、OpenAI和微软均已采用这一现代传输协议。

📋 协议备注Streamable HTTP 是已弃用的 HTTP+SSE 传输方式的现代替代方案。

Anthropic MCP 连接器

Anthropic的 MCP 连接器 允许您通过消息API直接使用Streamable HTTP服务器，而无需单独的MCP客户端。

MCP连接器非常适合此服务器，因为它使用的是可流式传输的HTTP架构。只需在API请求中包含此服务器：

curl https://api.anthropic.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-04-04" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1000,
    "messages": [{
      "role": "user", 
      "content": "What time is it in Tokyo?"
    }],
    "mcp_servers": [{
      "type": "url",
      "url": "https://your.worker.url.workers.dev",
      "name": "http-time-server"
    }]
  }'

Anthropic MCP连接器的优势：

  • 无需客户端设置 - 通过API直接连接
  • 原生可流式传输的HTTP支持 - 专为像这样的服务器设计

OpenAI智能体软件开发工具包（SDK）

OpenAI 还通过其（技术/服务）支持 Streamable HTTP 服务器 代理SDK 使用 MCPServerStreamableHttp 班级：

from agents.mcp.server import MCPServerStreamableHttp

# Connect to this Streamable HTTP server
server = MCPServerStreamableHttp({
    "url": "https://your.worker.url.workers.dev",
    "headers": {"Authorization": "Bearer your-token"},  # if needed
})

# Use the server in your OpenAI agent
await server.connect()
tools = await server.list_tools()
result = await server.call_tool("current_time", {"timezone": "Asia/Tokyo"})

Microsoft Copilot Studio（可译为“微软Copilot工作室”或根据具体语境简化为“微软Copilot平台”，但“Copilot Studio”本身作为专有名词，直接翻译时保留其特色，可译为“微软Copilot工作室”）

Microsoft Copilot Studio 现在支持可流式传输的 HTTP 服务器，配备有 MCP集成现已普遍可用您可以通过以下方式将此服务器连接到Copilot Studio：

  1. 构建自定义连接器 将您的MCP服务器与Copilot Studio连接起来
  2. 在Copilot Studio中添加工具 通过选择“添加工具”并搜索您的MCP服务器
  3. 直接使用服务器 在您的代理中启用生成式编排功能

更多MCP客户端即将问世

随着越来越多的MCP客户端开始支持Streamable HTTP，请保持关注。以下是一些资源，它们维护着MCP客户端及其功能的列表：

测试与验证

MCP 检查器工具（HTTP 模式）

使用这些基于网络的检查工具来测试您的服务器：

MCPCentral 工具（推荐）

官方MCP检查员

官方 MCP 检查器 也可提供：

  • 访问：https://github.com/modelcontextprotocol/inspector
  • 或者跑： npx @modelcontextprotocol/inspector

测试步骤

  1. 启动您的服务器：

    # Local HTTP server
npx wrangler dev

# Or use deployed URL: https://mcp.time.mcpcentral.io

  2. 与检查员联系：

    • 交通： 可流式传输的HTTP
    • 网址： http://localhost:8787 或者 https://mcp.time.mcpcentral.io
    • 点击 连接

命令行测试（标准输入输出模式）

直接测试stdio传输：

# Test initialization
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | npx @mcpcentral/mcp-time

# Test tool call
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"current_time","arguments":{"timezone":"America/New_York"}}}' | npx @mcpcentral/mcp-time

可用于测试的工具

检查员将展示所有六个与时间相关的工具：

  • **current_time**使用不同的时区进行测试（例如，“America/New_York”，“Europe/London”）
  • **relative_time**使用各种时间字符串进行测试（例如，“2024-12-25T00:00:00Z”）
  • **days_in_month**使用不同的月份和年份进行测试
  • **get_timestamp**将日期时间字符串转换为Unix时间戳
  • **convert_time**在不同的时区之间进行转换
  • **get_week_year**获取特定日期的周数

示例测试用例

在检查器中尝试这些测试用例：

// current_time
{"timezone": "Asia/Tokyo", "format": "iso"}

// relative_time  
{"time": "2024-12-25T00:00:00Z"}

// days_in_month
{"month": 2, "year": 2024}

// get_timestamp
{"time": "2024-06-15T12:00:00Z"}

// convert_time
{"time": "2024-06-15T12:00:00", "from": "UTC", "to": "America/Los_Angeles"}

// get_week_year
{"date": "2024-06-15"}

验证检查清单

使用检查器进行验证：

  • ✅ 服务器连接成功
  • ✅ 列出了所有6种工具
  • ✅ 工具模式已正确定义
  • ✅ 工具执行无错误
  • ✅ 结果格式正确
  • ✅ 错误处理适用于无效输入

MCP 检查器提供了最全面的方法来测试您的服务器，然后再将其与 AI 客户端集成。

身份验证与安全考虑因素

⚠️ 重要提示：此示例服务器未实施任何身份验证或安全措施。

相关 MCP