时间访问工具

Time MCP 是一个轻量级的模型上下文协议服务器,提供获取系统当前日期和时间的功能,适用于集成到 Claude、Gemini CLI 和其他 MCP 兼容的 LLM 应用中。

  • by DochertyDev
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 DochertyDev/time-mcp

使用说明

Time MCP

Effortless system time access, anywhere your LLM needs it.

:星: 爱情时光MCP?给我们一颗星,帮助其他开发人员发现它!



📋 目录

📄 概述

Time MCP是一个简单而轻量级的模型上下文协议(MCP)服务器,它提供了从系统中获取当前日期和时间的工具。它非常适合将时间相关功能集成到Claude、Gemini CLI和其他兼容MCP的LLM应用程序中。

此MCP通过一个集中、实用的用例演示了MCP的核心功能,该用例在所有MCP兼容平台上都能可靠地工作。

特性

此MCP提供以下工具:

  • get_current_time() -以HH:MM:SS格式返回当前时间
  • get_current_date() -以YYYY-MM-DD格式返回当前日期
  • get_current_datetime() -以ISO 8601格式返回日期和时间
  • get_time_components() -返回详细的时间细分(年、月、日、小时、分钟、秒、星期几)
  • get_unix_timestamp() -返回当前Unix时间戳

🚀 快速启动(地方发展)

先决条件

  • Python 3.9或更高版本
  • 点

来自PyPI(推荐)

发布后,您可以直接从PyPI安装:

pip install time-mcp

来源(发展)

  1. 克隆存储库:

    git clone https://github.com/DochertyDev/time-mcp.git
    
  2. 导航到项目目录:

    cd time-mcp
    
  3. 在开发模式下安装:

    pip install -e .
    
  4. 或者手动安装依赖项:

    pip install -r requirements.txt
    

运行服务器

要启动MCP服务器,请执行以下操作:

python src/server.py

服务器将启动并等待传入的MCP协议连接。

MCP检验员测试

使用MCP检查器调试和测试MCP:

mcp dev src/server.py

这将打开MCP检查器界面,您可以在其中交互式地测试每个工具。

⚙️ 用法

与Claude Desktop一起使用

要将此MCP添加到Claude Desktop,请更新您的 claude_desktop_config.json:

如果从PyPI安装:

{
  "mcpServers": {
    "time-mcp": {
      "command": "time-mcp"
    }
  }
}

如果从源代码安装:

{
  "mcpServers": {
    "time-mcp": {
      "command": "python",
      "args": ["C:\\path\\to\\time-mcp\\src\\server.py"]
    }
  }
}

替换 C:\path\to\time-mcp 带有时间mcp目录的实际路径。

与Gemini CLI一起使用

添加到您的Gemini CLI设置.json:

{
  "mcpServers": {
    "time-mcp": {
      "command": "time-mcp"
    }
  }
}

🛠️ 使用的技术

  • FastMCP框架
  • Python 3.9+
  • 点

🔒 安全说明

  • 此MCP仅从您的系统中访问与时间相关的信息
  • 没有文件系统访问权限
  • 无网络请求
  • 没有外部API调用
  • 无需凭据或机密

❓ 故障排除

问题:MCP检查器无法连接

  • 解决方案:确保安装了Python 3.9+,并且mcp包可用

问题:工具未出现在Claude中

  • 解决方案:确保MCP服务器正在运行,并在claude_desktop_config.json中正确配置

问题:导入错误

  • 解决方案:运行 pip install -r requirements.txt 确保所有依赖项都已安装

🤝 贡献

我们欢迎社区的贡献!如果您对改进或新功能有建议,请随时打开问题或提交拉取请求。

🌟 支持项目

爱情时光MCP? 给我们一个⭐ 在GitHub上!

如果您遇到任何问题,请打开问题 这里.

⚠️ 免责声明

该项目旨在用于教育和实验用途。虽然已尽一切努力确保其可靠性,但请负责任地使用它,并注意作者无法为每种情况提供保证。