AI导哈

时间智能服务器

Vreme Temporal MCP Server 提供全面的时间智能服务，包括时区转换、多种文化日历、天文事件、祈祷时间、全球假日数据、金融市场计算、商业时间计算、占星术、节日跟踪和日期范围操作。

  • by vreme-ai
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 vreme-ai/temporal-mcp

使用说明

Vreme临时MCP服务器

v1.9.4

MCP服务器提供全面的时间智能，包括时区转换、32个文化日历、天文事件、祈祷时间、247+个国家假日数据、5个金融市场、营业时间计算、占星术、观测跟踪、时区偏移智能和日期范围操作。

v1.9.4的新增功能

日期范围操作 -3个用于日期范围计算和设置操作的新工具：

  • date_range_overlap -检查两个日期范围是否重叠，并返回重叠详细信息（重叠日期、天数）
  • date_range_contains -检查日期是否在范围内，并返回位置数据（开始/结束/中间/之前/之后）
  • date_range_operations -对合并结果的日期范围（并集、交集、差值）执行设置操作

所有工具都只返回结构化的JSON数据（没有格式化的字符串），遵循Vreme的数据优先理念。非常适合检查可用性窗口、查找公共时段、检测日程冲突或组合时间范围。

概述

Vreme Temporal MCP Server为时态智能提供了59个专用工具，分为10类：

  • 核心时态工具 （7） -时间查询、祈祷时间、活动适当性
  • 假期和营业时间 （10） 247+个国家，工作日计算
  • 高级时态处理 （18） -时间算术、短语解析、冲突检查、持续时间计算
  • 日历和定期 （4） -多日历对齐，RRULE扩展
  • 模糊时间 （3） -不确定的时间表示
  • 天文的 （7） -日出/日落、黄道、月相
  • 观察与文化 （3） -宣传日、科技假期、纪念活动
  • 持续时间和期限 （5） -持续时间计算、周期分析、年龄计算
  • 时区偏移 （3） -时区偏移计算、夏令时转换、时区元数据
  • 日期范围操作 （3） -日期范围重叠检测、遏制检查、设置操作

工具参考

核心时态工具

get_temporal_text -提供实时时间感知。在每次响应之前致电，以获取当前时间、日期、时区、时间和活动跟踪。无需参数。

get_current时间 -获取当前时间、日期和时区信息。当用户询问“现在几点了？”时使用？或者在code/docs/changelogs中写入日期时。返回ISO日期时间、时区、day_of_week、date_string、time_string和time_of_day。无需参数。

查询时间 -关于时间、日历和仪式的自然语言查询。用于：“东京现在几点了？斋月是什么时候？“是排灯节吗？”？“月相是什么？”？'.返回丰富的上下文，包括日历、天文事件和文化纪念活动。

查询层时间 -获取任何地点的精确伊斯兰祈祷时间（萨拉赫/纳马兹）。返回所有5个每日祈祷（Fajr、Dhuhr、Asr、Maghrib、Isha）、下一个祈祷倒计时和麦加朝拜方向。

检查_活动_适当性 -检查现在打电话/工作/与某人见面是否合适。考虑一天中的时间、文化仪式（安息日、斋月斋戒）、宗教工作限制和不同日历系统的当地习俗。

分析时态文本 -对特定日期进行全面分析，包括所有日历表示、文化纪念活动、天文事件、商业背景、季节信息和时间密度得分（0-100显著性）。

比较日期 -比较两个日期，了解时间距离和意义。返回时差、每个日期的纪念活动、共享的纪念活动，以及哪个更具文化意义。

假期和营业时间

计算业务时间 -计算工作日/小时，考虑周末和节假日。操作：add_days、days_between、hours_bween、is_working_day。

列表_假期_国家 -列出所有支持假期数据的247+个国家。返回国家代码和名称。

获取_国家_假期 -获取特定年份一个国家的所有假期。返回每个假期的日期、名称和类别（公共、银行、学校、可选）。可以按类别过滤。快速：<30ms。

检查_假期 -检查日期是否为一个国家的公共假日（政府关闭）。如果是，则返回假日名称，如果不是，则返回null。最快假日工具（<10ms）。

列表_金融_市场_假期 -列出所有5个受支持的金融市场及其交易假期日历。回报：XNYS（纽约证券交易所）、XNSE（印度NSE）、BVMF（巴西）、XECB（欧洲央行TARGET2）、IFEU（欧洲ICE期货）。

get_market_holidays -当金融市场关闭时，享受所有交易假期。用于：“纽约证券交易所2024年何时关闭？NSE印度交易假期是什么？'.市场：XNYS、XNSE、BVMF、XECB、IFEU。快速：<20ms。

检查_营业日 -检查日期是否为工作日（不是假日，也不是周末）。返回是/否，并详细说明原因。当用户询问“营业日”或“工作日”时，更喜欢这样做而不是check_holiday。快速：<10ms。

validate_date -验证日期是否有效（例如，赶上2月30日，第13个月）。返回详细的错误和智能修复建议。检查闰年、月边界等。速度：<5ms。

add_business_days_detailed -添加/减去工作日，并获取有关排除内容的详细元数据。显示跳过的周末、假期和日历跨度。快速：<20ms。

resolve_relater_date -将“下周一”、“明天”、“3天后”等表达式转换为实际日期。使用简单的、有文件记录的规则。支持夜间程序员的“弹性明天”（选择加入）。

高级时态处理

execute_time_算法 -使用业务规则执行精确的日期/时间计算。支持操作：加、减、set_time、set_date。使用区域假日日历处理business_days。使用确定性哈希返回分步执行跟踪。

resolve_temporal_phrase -将“明晚”、“周末”、“下周初”等自然语言短语转换为具体的时间窗口。返回具有开始/结束时间、置信度得分（0-1）和替代解释的规范窗口。

比较临时短语 -比较两个时态短语，分析它们之间的关系。返回时间差、重叠分析（较早/较晚）和人类可读的比较。

export_temporal_text_snapshot -为Multi-LLM系统导出可移植的时态上下文。返回TemporalContextSnapshotV1模式，包括当前时间、日历、即将发生的事件、节奏指纹和可选工件。

generate_temporal_prompt_prefix -将时态上下文快照转换为简洁的LLM就绪提示前缀。可配置的最大行数（默认值：20）。针对系统提示进行了优化。

检查_良好时刻_活动 -检查现在是否是活动的好时机。活动：深度工作、财务决策、硬反馈、创意游戏、锻炼。返回是/否、分数（0-1）、原因和建议的替代时间。

check_temporal_冲突 -分析事件与假期、周末、睡眠时间、工作限制的冲突。返回每个事件的冲突分析、总体风险水平、摘要。多区域假期检查和睡眠模式分析。

解释时间行为 -获取复杂时间概念的简单解释。主题：dst_transition（夏令时变化），business_days（它们是如何工作的），时区差异（两个时区之间）。返回标题、解释和要点。

分析全球牺牲时间 -产品发布、网络研讨会、维护窗口的多区域神圣时间分析。退货避开窗口（斋月、宗教节日），首选窗口。支持宗教：伊斯兰教、基督教、印度教、佛教。

get_weekly_sacred_rythm -为多元文化团队生成7天×24小时的网格。显示宗教仪式（Jumu'ah、安息日、周日礼拜）的总分，严重程度评分为（0-1）。返回定期会议的建议。

get_microseason_context -获取位置和日期的季节性微观背景。返回微地震ID/名称、日长、日出/日落、描述、建议音调。半球感知的季节分类。

convert_time_scale -在不同时间尺度（Unix秒、Unix毫秒、UTC ISO、本地ISO）之间转换。本地转换的显式时区处理。批量转换支持。

list_time_scales -列出所有支持的时间尺度，并附上说明和示例。显示：UNIX_SECONDS、UNIX_MILLIS、UTC_ISO、LOCAL_ISO（TAI、GPS计划）。

持续时间和期限

计算持续时间 -计算两个时间戳之间的结构化持续时间。将total_seconds、days、hours、minutes、seconds作为单独的数字字段返回。用于计算事件之间的时间差、经过时间或持续时间。

计算周期 -计算两个日期之间的周、月、季度或年。以天、周、月、季度和年作为单独的数字字段返回结构化数据。准确处理闰年和闰月边界。

年龄_出生日期 -根据出生日期将年龄作为结构化数据计算。将年、月、日和total_days作为单独的数字字段返回。准确处理闰年和闰月边界。

时间_直到 -计算时间，直到未来的时间戳。返回结构化的持续时间数据（total_seconds、days、hours、minutes、seconds），并指示时间是否在过去。

时间_开始 -计算自过去时间戳以来的时间。返回结构化的持续时间数据（total_seconds、days、hours、minutes、seconds），并指示时间是否在未来。

时区偏移

get_timezone_offset -将两个时区之间的偏移作为结构化数据获取。返回两个时区的offset_seconds、offset_hours、is_dst状态以及夏令时转换信息。用于计算时区之间的时差并了解夏令时的影响。

比较时区 -比较多个时区，返回每对时区的偏移数据。返回结构化比较数据，显示所有时区对之间的偏移、每个时区的当前时间和夏令时状态。

get_timezone_info -获取时区元数据，包括UTC偏移、夏令时规则和下一个/上一个夏令时转换。返回有关时区属性、当前夏令时状态和转换信息的结构化数据。

日期范围操作

日期_范围_重叠 -检查两个日期范围是否重叠，并返回重叠详细信息。返回布尔值、重叠开始/结束日期和重叠天数。用于检查两个时间段是否重叠、查找共同的可用性窗口或检测调度冲突。

日期_范围_内容 -检查日期是否在范围内，并返回位置数据。返回布尔值、位置（开始/结束/中间/之前/之后）和从开始/结束的天数。用于检查日期是否在某个时间段内，查找日期的相对位置，或验证范围内的日期成员资格。

日期_日期_操作 -对日期范围（并集、交集、差分）执行设置操作。返回合并后的结果范围，包括总天数和计数。用于组合可用性窗口、查找公共时段或从可用时段中减去阻塞时间。

日历和周期

间隔作战 -按时间间隔执行设定操作。操作：UNION（合并区间）、INTERSECTION（查找重叠）、DIFFERENCE（相减）、GAPS（查找间隙）。处理具有归一化输出的重叠和相邻间隔。

expand_recurrency -将RRULE重复模式（RFC 5545）扩展到时间窗口内的具体事件。支持完整的RRULE语法（FREQ=WEEKLY；BYDAY=MO、WE、FR）。安全限制：最多1000次。

align_calendars -在多个日历系统中显示单个按时间顺序排列的时刻。支持：Gregorian、Unix、ISO Week、Ordinal（更多计划：伊斯兰、希伯来语、中文）。

查找部分日期 -在搜索范围内查找与部分规格匹配的所有日期。按年、月、日限制搜索。

模糊时间

create_fuzzy_time_circa -从具有显式不确定性的大致日期表达式创建模糊时间表示。精度级别：年、月、日。返回中心点、窗口和置信度得分（0-1）。用于“大约1990年”，具有不确定性的历史日期。

create_fuzzy_time_window -使用自定义置信度评分从显式时间窗口创建模糊时间。用于不确定的未来事件、灵活的日程安排、时间估计。返回中心点、窗口边界和置信度得分。

交叉模糊时间 -用精确的置信度找到两个模糊时间的交点。当两个不确定的时间范围重叠时，这将使用组合置信度评分计算它们的交集。

天文的

get_astro_context -获取日期和地点的日出、日落、日长、黄昏时间和月相。返回太阳正午、以小时为单位的日长、民用黄昏边界和当前月相。

get_day_phase -根据太阳位置将时间戳分为白天阶段（孕日、早晨、中午、下午、傍晚、夜晚）。返回相位、地平线上/地平线下的太阳以及相对于日出/日落的时间。

get_season_text -获取半球感知的日期和地点的季节分类。返回季节（冬季、春季、夏季、秋季，有早/晚变体）、半球、一年中的某一天和上下文注释。

get_zodiac_context -获取时间戳的行星位置、星座和相位。返回黄道经度、符号（带元素/模态）和身体之间的相位（合、对、三分相、正方形、六分相）。

get_chinese _生肖 -获取中国十二生肖动物、元素和60年周期作为约会对象。返回阴历年、动物（鼠到猪）、元素（木/火/土/金属/水）、阴阳和循环指数。

获取事件 -在时间窗口内获取天文事件。返回太阳进入（太阳进入每个黄道星座）和月相（新月、第一季度、满月、最后一季度），并带有精确的UTC时间戳。

get_astro_calendar -获取用户时区内日期范围的占星术日历。返回太阳进入和月相以及当地时间和人类可读的描述。

观察与文化

get_observances_ondate -为特定日期举办意识日、欢乐日、纪念活动和文化庆典。分类：awareness_day，fun_day，技术，季节性，纪念活动，文化，宗教，企业。

get_today_故事 -根据用户的地区和兴趣，获取今天的精选活动——最相关的纪念活动。返回1-3个具有相关性评分的观察结果。

get_observances_calendar -获取特定月份纪念活动的日历视图。按天返回计划和UI日历显示的所有观察结果。

特性

全球假日情报

  • 247+个国家拥有全面的假期数据
  • 类别支持：公共（政府关闭）、银行、学校、可选
  • 5个金融市场：纽约证券交易所、NSE印度、巴西B3、欧洲央行TARGET2、ICE欧洲期货
  • 由python holidays v0.86提供技术支持+

文化日历

32个日历系统，涵盖宗教、文化和技术日历：

宗教与文化： 希伯来语、伊斯兰语、汉语、印度教、波斯语、佛教、锡克教、科普特语、东正教、埃塞俄比亚语、巴哈伊语、泰国佛教、Tibetan语、琐罗亚斯德教、亚美尼亚语、爪哇语、蒙古语、缅甸语

东亚： 日语、孟加拉语、泰米尔语、尼泊尔语

西方和技术： 玛雅人、罗马人、法国大革命者、修订版朱利安、Discordian、全新世、Unix时代、ISO周日期、西十二生肖、《星际迷航》星际日期

覆盖范围：50多亿人，10多种宗教，300多种纪念活动

伊斯兰祈祷时间

  • 所有5个每日祈祷：法吉尔、杜尔、阿斯尔、马格里布、Isha
  • 7种计算方法：MWL、ISNA、埃及、麦加、卡拉奇、德黑兰、贾法里
  • 朝拜方向麦加
  • 下一次祈祷倒计时

天文和天文数据

  • 日出、日落、黄昏
  • 月相和阴历
  • 西方十二宫：行星位置、星座、相位
  • 中国十二生肖：动物和元素循环
  • 太阳侵入和天文事件

安装

快速开始

npx -y @vreme/temporal-mcp

码头工人

docker pull vreme/temporal-mcp
docker run --rm -i vreme/temporal-mcp

配置

克劳德桌面版

添加到您的 claude_desktop_config.json:

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
窗户： %APPDATA%\Claude\claude_desktop_config.json
Linux： ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "vreme": {
      "command": "npx",
      "args": ["-y", "@vreme/temporal-mcp"]
    }
  }
}

Docker配置：

{
  "mcpServers": {
    "vreme": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "vreme/temporal-mcp"]
    }
  }
}

VS Code

手动配置：

打开命令选项板(Ctrl + Shift + P) → MCP: Open User Configuration

添加到您的 mcp.json:

{
  "servers": {
    "vreme": {
      "command": "npx",
      "args": ["-y", "@vreme/temporal-mcp"]
    }
  }
}

VS代码MCP文档

继续并坚持

按照相应的设置指南添加到MCP配置中。

查询示例

时区和时间：

  • “东京现在几点了？”
  • “现在是给伦敦打电话的好时机吗？”

宗教与文化：

  • “耶路撒冷是安息日吗？”
  • “今年斋月是什么时候？”
  • “迪拜的祈祷时间是什么时候？”

假期和商务：

  • “明天德国放假吗？”
  • “12月20日增加5个工作日”
  • “纽约证券交易所2025年何时关闭？”

天文学的：

  • “巴黎的日出是什么时候？”
  • “今天的月相是什么？”
  • “我的星座是什么？”

日历：

  • “今天希伯来语是几号？”
  • “中国新年是什么时候？”
  • “显示伊斯兰日历中的这个日期”

设计理念

Vreme专注于具有无状态、数据优先架构的时态智能：

  • 无状态&快速 -无数据库查询，响应时间低于100ms，可无限扩展
  • 仅限结构化数据 -JSON响应，无格式或HTML，最大可组合性
  • 事实与权威 -经过验证的假期数据、精确的日历系统、值得信赖的天文计算
  • 重点范围 -仅限于时间数据、计算和文化日历。无日程安排、文本生成、事件存储或通知

建筑

AI Client (Claude Desktop / VS Code / Continue / Cline)
    ↓ MCP Protocol
@vreme/temporal-mcp
    ↓ HTTPS
vreme.ai API
    ↓
Temporal Intelligence Engine

API访问

此MCP服务器由 时间 API.

API的直接使用：

curl -X POST https://api.vreme.ai/query \
  -H "Content-Type: application/json" \
  -d '{"query": "What time is it in Tokyo?"}'

发展

从源代码构建

npm install
npm run build
npm link

Docker构建

docker build -t vreme/temporal-mcp .

调试

查看MCP服务器日志：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

链接

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

关于Vreme

Vreme（保加利亚语：“时间”）为人工智能系统构建时间智能。我们的使命是让人工智能在时间上感知，理解全球的时间、文化和背景。

相关 MCP