AI导哈

时间服务协议

一个简单的MCP协议服务器，提供当前UTC时间功能，可全局集成到Cursor IDE中，为所有项目提供时间相关能力。

  • by elimS2
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 elims2/mcp-time-server

使用说明

MCP时间服务器

提供当前UTC时间功能的简单模型上下文协议（MCP）服务器。此服务器可以与Cursor IDE全局集成，以在所有项目中提供与时间相关的功能。

特性

  • 以多种格式获取当前UTC时间
  • 简单的MCP协议实现
  • 全局游标IDE集成
  • 重量轻，速度快

安装

先决条件

  • Python 3.8或更高版本
  • pip包管理器

从源代码安装

  1. 克隆或下载此存储库
  2. 导航到项目目录
  3. 安装软件包：
pip install -e .

仅安装依赖项

pip install -r requirements.txt

用法

运行服务器

# Run directly
python -m mcp_time_server.server

# Or use the installed script
mcp-time-server

可用工具

get_current_time_utc

获取各种格式的当前UTC时间。

参数：

  • format （可选）：输出格式
    • "iso" （默认）：ISO 8601格式（2025-01-15T10:30:45Z）
    • "datetime"：人类可读格式（2025-01-15 10:30:45）
    • "timestamp"：Unix时间戳（1736939445）

示例响应：

Current UTC time: 2025-01-15T10:30:45.123456Z
Format: iso
Full ISO: 2025-01-15T10:30:45.123456Z

游标IDE集成

全局配置（推荐）

对于所有项目的永久集成：

  1. 创建全局MCP配置文件：

    • 视窗: C:\Users\[USERNAME]\.cursor\mcp.json
    • macOS/Linux: ~/.cursor/mcp.json

  2. 添加以下配置：

{
  "mcpServers": {
    "time-server": {
      "command": "python",
      "args": ["-m", "mcp_time_server.server"],
      "cwd": "/full/path/to/mcp-time-server/src",
      "env": {
        "PYTHONPATH": "/full/path/to/mcp-time-server/src"
      }
    }
  }
}
  1. 重新启动游标IDE
  2. 检查 Tools & Integrations > MCP 验证服务器是否已启用

服务器现在将自动从Cursor IDE启动，并在所有项目中工作！

项目特定配置

仅供项目使用，创建 .cursor/mcp.json 在您的项目目录中，使用相同的结构。

发展

开发设置

# Install with development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Format code
black src/
isort src/

# Type checking
mypy src/

项目结构

mcp-time-server/
├── src/
│   └── mcp_time_server/
│       ├── __init__.py
│       └── server.py
├── pyproject.toml
├── requirements.txt
├── README.md
├── mcp_config.json
└── PROJECT_PLAN.md

测试

测试服务器功能：

from mcp_time_server.server import get_current_time_utc

# Test different formats
print(get_current_time_utc("iso"))
print(get_current_time_utc("datetime"))
print(get_current_time_utc("timestamp"))

故障排除

常见问题

  1. 导入错误：确保该软件包已安装 pip install -e .
  2. MCP连接问题：验证MCP配置中的服务器路径
  3. 权限错误：确保Python具有运行服务器所需的权限
  4. 服务器未出现：检查 .cursor 目录存在并且 mcp.json 格式正确

Windows PowerShell

如果您遇到以下问题 && PowerShell中的运算符，请使用：

cd src; python -m mcp_time_server.server

验证服务器状态

检查服务器是否正在运行：

# Windows
tasklist | findstr python
wmic process where "name='python.exe'" get ProcessId,CommandLine /format:list

# macOS/Linux  
ps aux | grep mcp_time_server

在Cursor中测试连接： 让AI助手获取当前时间——它应该自动使用MCP时间服务器。

手动服务器管理

手动启动服务器：

cd src && python -m mcp_time_server.server

停止服务器：

# Windows (replace PID with actual process ID)
taskkill /PID [PID] /F

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 如果适用，添加测试
  5. 提交拉取请求

更新日志

v0.1.0

  • 初始版本
  • 基本UTC时间功能
  • MCP协议合规性
  • FastMCP集成，简化服务器管理
  • 全局游标IDE配置支持
  • 多种时间格式（ISO、日期时间、时间戳）
  • 全面的测试和记录
  • 流程管理和故障排除工具
  • 具有MIT许可证的GitHub存储库
  • 在重启周期中确认了现场测试

相关 MCP