passage-of-time-mcp完全指南:5分钟搭建AI时间计算服务器
【免费下载链接】passage-of-time-mcp🤖🕰️ An MCP server that gives language models temporal awareness and time calculation abilities. Teaching AI the significance of the passage of time through collaborative tool development.项目地址: https://gitcode.com/gh_mirrors/pa/passage-of-time-mcp
passage-of-time-mcp是一款强大的MCP服务器,它赋予语言模型时间感知和时间计算能力,通过协作工具开发帮助AI理解时间流逝的意义。无论是处理时间差计算、时间戳解析还是获取时间上下文,这款工具都能让AI轻松应对各类时间相关任务。
🌟 为什么选择passage-of-time-mcp?
在与AI交互的过程中,你是否遇到过这样的问题:当询问"两个日期之间相差多久"或"某个时间点是工作日还是周末"时,AI常常无法给出准确答案?这是因为大多数语言模型本身缺乏时间计算能力和时间感知能力。
passage-of-time-mcp正是为解决这一痛点而生。它就像给AI配备了一个专业的"时间计算器",让AI能够准确处理各种时间相关任务,从而提供更智能、更贴心的服务。
图:passage-of-time-mcp提供的时间工具界面,让AI拥有强大的时间计算能力
🚀 快速开始:5分钟搭建步骤
🔧 准备工作
在开始之前,请确保你的系统满足以下要求:
- Python 3.12或更高版本
- pipenv(或pip)
- 兼容MCP的客户端(如Claude.ai、Continue.dev等)
⚙️ 安装步骤
- 克隆仓库
git clone https://gitcode.com/gh_mirrors/pa/passage-of-time-mcp cd passage-of-time-mcp- 安装依赖
pipenv install # 或使用pip: pip install fastmcp pytz- 启动服务器
pipenv run server # 或直接运行: pipenv run python passage_of_time_mcp.py服务器将在http://0.0.0.0:8000/sse上启动,现在你已经成功搭建了AI时间计算服务器!
🔌 连接到Claude.ai
要让Claude等AI模型使用你的时间计算服务器,请按照以下步骤操作:
- 在Claude.ai中,进入设置 → 集成
- 点击"添加集成"并选择"自定义"
- 输入服务器URL(如果使用ngrok等工具暴露本地服务器,URL格式类似
https://your-server.ngrok-free.app/sse,确保末尾添加/sse) - 保存并启用所有时间相关工具
图:在Claude界面中配置passage-of-time-mcp服务器,每个工具都有清晰的描述和权限设置
提示:对于本地开发,你需要使用ngrok等工具将服务器暴露到公网,或直接部署到云服务器。
🛠️ 强大的时间工具功能
passage-of-time-mcp提供了一系列实用的时间工具,让AI能够轻松处理各种时间相关任务:
current_datetime:获取当前时间
返回当前日期和时间,是AI时间感知的基础。支持指定时区,默认使用"America/New_York"。
示例返回:"2024-01-15 14:30:45 EST"time_difference:计算时间差
计算两个时间戳之间的持续时间,并提供人类可读的输出。支持多种时间单位,如秒、分钟、小时和天。
timestamp_context:时间戳上下文
提供时间戳的人类上下文信息,如时间段(早上、下午等)、星期几、是否为周末、是否为工作时间等。
图:passage-of-time-mcp提供的各种时间工具详细设置界面
time_since:计算时间流逝
计算某个时间点到现在经过了多长时间,并提供上下文描述,如"2小时前"、"昨天"等。
parse_timestamp:解析时间戳
在不同格式之间转换时间戳,提高兼容性。支持ISO格式、Unix时间戳、人类友好格式等。
add_time:时间加减
在给定时间戳上添加或减去指定时长,并提供自然语言描述,如"明天下午2:30"。
format_duration:格式化时长
将秒数格式化为人类可读的文本,支持多种风格:完整风格("2小时30分钟15秒")、紧凑风格("2h 30m 15s")和极简风格("2:30:15")。
💡 实际应用场景
passage-of-time-mcp可以在多种场景中发挥作用,让AI的回答更加智能和贴心:
基本时间感知
人类:现在几点了? Claude:[调用current_datetime] 现在是2024年1月15日星期一下午3:45(EST)。对话节奏分析
人类:让我们讨论一下AI意识。 Claude:[每次响应开始时调用current_datetime] [几次交流后] 人类:你注意到我们对话中有什么模式吗? Claude:查看时间戳,我发现你在响应之间会间隔30秒到2分钟,表明你在积极参与。在你提出关于实现的问题之前有3分钟的停顿,显示出你在深入思考...理解工作上下文
人类:[晚上11:45] 你能帮我调试这段代码吗? Claude:[调用current_datetime,然后调用timestamp_context] 我注意到现在是工作日的深夜。考虑到已经快午夜了,我会帮你高效解决问题,这样你就能休息了。以下是一个专注的调试方法...🌍 时区和时间戳格式
支持的时区
服务器默认使用"America/New_York"时区,但支持所有标准时区名称:
- UTC
- US/Pacific
- Europe/London
- Asia/Tokyo
- 等等
时间戳格式
所有时间戳必须使用以下格式之一:
- 完整格式:
YYYY-MM-DD HH:MM:SS(例如:"2024-01-15 14:30:45") - 仅日期:
YYYY-MM-DD(例如:"2024-01-15")
这种严格的格式可以防止歧义,确保计算的可靠性。
📊 集成到你的工作流
passage-of-time-mcp可以轻松集成到各种AI工作流中,提升AI处理时间相关任务的能力。以下是一些集成建议:
智能助手:让你的AI助手能够理解时间概念,更好地帮助日程安排和时间管理。
数据分析:结合时间上下文分析用户行为模式,提供更有洞察力的报告。
客户服务:让AI客服能够理解不同时区客户的时间,提供更贴心的服务。
内容创作:帮助AI在创作时考虑时间因素,如季节性内容、时间敏感信息等。
图:passage-of-time-mcp已成功集成到Claude的集成列表中
🛣️ 未来发展路线图
passage-of-time-mcp项目正在不断发展,未来计划添加以下功能:
- 迁移到现代
http-stream传输协议 - 添加Docker支持,简化部署
- 创建浏览器扩展,方便本地开发
- 支持用户自定义活动模式
- 日历集成
- 自然语言时间解析(如"下周二"、"3小时后")
🤝 贡献和支持
如果你对passage-of-time-mcp感兴趣,欢迎通过以下方式参与项目:
- 提交bug报告和功能建议
- 贡献代码,实现新功能
- 改进文档,帮助更多用户
- 在社交媒体上分享你的使用体验
项目源代码位于 passage_of_time_mcp.py,欢迎查阅和贡献。
📝 许可证
本项目采用Mozilla Public License 2.0,这意味着好的想法应该传播,同时保持开放。
通过passage-of-time-mcp,我们不仅在构建更好的LLM工具,还在教这些好奇的认知系统理解人类的时间体验——一次一个时间戳。现在就开始使用,让你的AI拥有真正的时间感知能力吧!
【免费下载链接】passage-of-time-mcp🤖🕰️ An MCP server that gives language models temporal awareness and time calculation abilities. Teaching AI the significance of the passage of time through collaborative tool development.项目地址: https://gitcode.com/gh_mirrors/pa/passage-of-time-mcp
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考