Time MCP Docker

时间MCP服务器

用于时间感知和时区操作的多架构Docker镜像

______________________________________________________________________

📋 目录

• 概述
• 支持的架构
• 可用标签
• 快速开始
• 配置
• MCP客户端配置
• 网络配置
• 更新
• 故障排除
• 附加资源
• 支持和许可
• 重大变化

______________________________________________________________________

😎 请我喝杯咖啡☕︎

您的支持鼓励我继续创建/支持我的开源项目。 如果你在这个项目中发现了价值，你可以给我买杯咖啡，让我保持灵感。

概述

时间MCP服务器通过模型上下文协议提供时间感知和时区操作功能。基于Alpine Linux构建，占用空间最小，安全性最高。

主要特点

✨ 多架构支持 -原生支持x86-64和ARM64\ 🚀 多种传输协议 -HTTP、SSE和WebSocket支持\ 🔒 设计安全 -基于阿尔卑斯山，攻击面最小\ ⚡ 高性能 -ZSTD压缩可实现更快的部署\ 🎯 生产就绪 -经过全面测试的稳定版本\ 🔧 易于配置 -简单的环境变量设置

______________________________________________________________________

支持的架构

💡 多拱形图像会自动为您的系统选择正确的架构。

______________________________________________________________________

可用标签

系统要求

• Docker引擎： 23.0+
• 猛撞： 最小512MB
• CPU： 单芯足够

🔒 关键： 在没有适当的安全措施（反向代理、SSL/TLS、身份验证、防火墙规则）的情况下，不要将此容器直接暴露在互联网上。

______________________________________________________________________

快速开始

Docker Compose（推荐）

services:
  time-mcp:
    image: mekayelanik/time-mcp:stable
    container_name: time-mcp
    restart: unless-stopped
    ports:
      - "8060:8060"
    environment:
      - PORT=8060
      - INTERNAL_PORT=38011
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Dhaka
      - NODE_ENV=production
      - PROTOCOL=HTTP
      - ENABLE_HTTPS=false
      - HTTP_VERSION_MODE=auto
      # Optional: require Bearer token auth at HAProxy layer
      # - API_KEY=replace-with-strong-secret
    hostname: time-mcp
    domainname: local

部署：

docker compose up -d
docker compose logs -f time-mcp

Docker命令行界面

docker run -d \
  --name=time-mcp \
  --restart=unless-stopped \
  -p 8060:8060 \
  -e PORT=8060 \
  -e INTERNAL_PORT=38011 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Dhaka \
  -e NODE_ENV=production \
  -e PROTOCOL=HTTP \
  -e ENABLE_HTTPS=false \
  -e HTTP_VERSION_MODE=auto \
  mekayelanik/time-mcp:stable

访问端点

启用HTTPS时(ENABLE_HTTPS=true)，使用TLS端点：

⚠️ 安全警告： 容器现在默认为HTTP(ENABLE_HTTPS=false)以便于本地设置。使用 ENABLE_HTTPS=true 用于生产、公共网络或任何不受信任的环境。 ⏱️ ARM设备： 在访问端点之前，请允许30-60秒进行初始化。

______________________________________________________________________

配置

环境变量

HTTPS和HTTP版本说明

• 如果 ENABLE_HTTPS=true 如果缺少证书文件，容器会自动生成自签名证书。
• 如果 TLS_CERT_PATH 和 TLS_KEY_PATH 存在，它们被合并到 TLS_PEM_PATH 并直接使用。
• HTTP_VERSION_MODE=h3 （或 auto)仅当HAProxy构建包含QUIC时才启用HTTP/3；否则，它会安全地回落。

API密钥验证说明

• 集 API_KEY 以在反向代理级别强制执行身份验证。
• 预期的标题格式： Authorization: Bearer .
• 本地主机健康检查仍然可以访问活动/准备状态。

速率限制和IP访问控制

• 速率限制： 集 RATE_LIMIT=100 允许每100个请求 RATE_LIMIT_PERIOD （默认值 10s)每个IP。超过限制将返回HTTP 429 Retry-After 头球
• 连接限制： 集 MAX_CONNECTIONS_PER_IP=50 限制每个IP的并发连接。超过此值将返回HTTP 429。
• IP阻止列表： 集 IP_BLOCKLIST=192.0.2.0/24,198.51.100.5 以阻止特定IP/CIDR。被阻止的IP接收HTTP 403。
• IP地址列表： 集 IP_ALLOWLIST=10.0.0.0/8,192.168.1.0/24 只允许列出的IP/CIDR。所有其他人都接收HTTP 403。始终允许本地主机。
• 所有功能默认为禁用。根据需要进行组合——在分配列表之前检查块列表。

用户和组ID

找到您的ID并设置它们以避免权限问题：

id username
# uid=1000(user) gid=1000(group)

时区示例

- TZ=Asia/Dhaka        # Bangladesh
- TZ=America/New_York  # US Eastern
- TZ=Europe/London     # UK
- TZ=UTC               # Universal Time

______________________________________________________________________

MCP客户端配置

运输支持

⚠️ \*WebSocket是实验性的(第1288期)

______________________________________________________________________

VS代码（Cline/Roo-Cline）

在中配置 .vscode/settings.json:

{
  "mcp.servers": {
    "time-mcp": {
      "url": "http://host-ip:8060/mcp",
      "transport": "http"
    }
  }
}

______________________________________________________________________

克劳德桌面应用程序/克劳德代码

配置：

带API_KEY

claude mcp add-json github '{"type":"http","url":"http://localhost:8045/mcp","headers":{"Authorization":"Bearer "}}'

不带API_KEY

claude mcp add-json github '{"type":"http","url":"http://localhost:8045/mcp"}'

______________________________________________________________________

Codex CLI

在中配置 ~/.codex/config.json:

{
  "mcpServers": {
    "time-mcp": {
      "transport": "http",
      "url": "http://host-ip:8060/mcp"
    }
  }
}

______________________________________________________________________

Codeium（风帆）

在中配置 .codeium/mcp_settings.json:

{
  "mcpServers": {
    "time-mcp": {
      "transport": "http",
      "url": "http://host-ip:8060/mcp"
    }
  }
}

______________________________________________________________________

光标

在中配置 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "time-mcp": {
      "transport": "http",
      "url": "http://host-ip:8060/mcp"
    }
  }
}

______________________________________________________________________

测试配置

证实 MCP检查员:

npm install -g @modelcontextprotocol/inspector
mcp-inspector http://host-ip:8060/mcp

______________________________________________________________________

网络配置

比较

______________________________________________________________________

网桥网络（默认）

services:
  time-mcp:
    image: mekayelanik/time-mcp:stable
    ports:
      - "8060:8060"

优点： 容器隔离，易于设置，适用于任何地方 访问权限： http://localhost:8060/mcp

______________________________________________________________________

主机网络（仅限Linux）

services:
  time-mcp:
    image: mekayelanik/time-mcp:stable
    network_mode: host

优点： 最高性能，无NAT开销，无需端口映射 注意事项： 仅限Linux，共享主机网络命名空间 访问权限： http://localhost:8060/mcp

______________________________________________________________________

MACVLAN网络（高级）

services:
  time-mcp:
    image: mekayelanik/time-mcp:stable
    mac_address: "AB:BC:CD:DE:EF:01"
    networks:
      macvlan-net:
        ipv4_address: 192.168.1.100

networks:
  macvlan-net:
    driver: macvlan
    driver_opts:
      parent: eth0
    ipam:
      config:
        - subnet: 192.168.1.0/24
          gateway: 192.168.1.1

优点： 专用IP，直接局域网接入 注意事项： 仅限Linux，需要额外设置 访问权限： http://192.168.1.100:8060/mcp

______________________________________________________________________

更新

Docker Compose

docker compose pull
docker compose up -d
docker image prune -f

Docker命令行界面

docker pull mekayelanik/time-mcp:stable
docker stop time-mcp && docker rm time-mcp
# Run your original docker run command
docker image prune -f

Watchtower的一次性更新

docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once \
  time-mcp

______________________________________________________________________

故障排除

飞行前检查表

• ✅ Docker引擎23.0+
• ✅ 端口8060可用
• ✅ 充足的启动时间（ARM设备）
• ✅ 最新稳定图像
• ✅ 配置正确

常见问题

容器无法启动

# Check Docker version
docker --version

# Verify port availability
sudo netstat -tulpn | grep 8060

# Check logs
docker logs time-mcp

权限错误

# Get your IDs
id $USER

# Update configuration with correct PUID/PGID
# Fix volume permissions if needed
sudo chown -R 1000:1000 /path/to/volume

客户端无法连接

# Test connectivity
curl http://localhost:8060/mcp
curl http://host-ip:8060/mcp
curl -k https://localhost:8060/mcp
curl -k https://host-ip:8060/mcp

# Check firewall
sudo ufw status

# Verify container
docker inspect time-mcp | grep IPAddress

ARM性能缓慢

• 启动后等待30-60秒
• 监视器： docker logs -f time-mcp
• 检查资源： docker stats time-mcp
• 使用更快的存储（SSD与SD卡）

调试信息

报告问题时，包括：

# System info
docker --version && uname -a

# Container logs
docker logs time-mcp --tail 200 > logs.txt

# Container config
docker inspect time-mcp > inspect.json

______________________________________________________________________

附加资源

文档

• 📚 时间官方文件
• 📦
• 🔧 MCP检查员

Docker资源

• 🐳
• 🌐
• 🛡️

监控

• 📊 Diun-更新通知器
• ⚡ 守望塔

______________________________________________________________________

😎 请我喝杯咖啡☕︎

您的支持鼓励我继续创建/支持我的开源项目。 如果你在这个项目中发现了价值，你可以给我买杯咖啡，让我保持灵感。

支持和许可

获取帮助

Docker镜像问题：

• github：

时间MCP问题：

• github： 尼古拉斯·格里芬/时代媒体/issues
• 网站：

贡献

我们欢迎捐款：

1. 通过GitHub Issues报告错误
2. 建议功能
3. 改进文档
4. 测试版发布

许可证

GPL许可证。看 许可证 了解详情。

时间MCP服务器有自己的许可证-请参阅 .

______________________________________________________________________

重大变化

Initial Release: Full CI/CD pipeline with HAProxy, HTTPS/TLS, QUIC/HTTP3, API key auth

⬆ 返回顶部