Time.ir Calendar

time-ir-mcp：面向 AI Agent 的 Time.ir 伊朗历法 MCP 服务

time-ir-mcp 是一款非官方、只读的 MCP 服务，可向 AI Agent 提供 Time.ir（تایم، تقویم و ساعت ایران）的伊朗历法。
它提供 13 个工具，可查询今天的伊朗历、格里高利历和回历日期，转换日期，查看某个月的日期及其事件，
列出某日或某年的纪念日和官方节假日、查找即将到来的节假日，并查询伊朗城市今天的礼拜时间（اوقات شرعی）。
无需 API 密钥或账户。它可用于 Claude、Cursor、Copilot 和任何其他 MCP 客户端。

面向 AI Agent · 快速开始 · 工具 · 须知 · فارسی

---

面向 AI Agent

• 简介： 面向 time.ir 的非官方 MCP 服务（模型上下文协议），提供伊朗日期和时间的三种历法、日期转换、官方节假日、每月和每日纪念日（مناسبت‌ها）以及伊朗城市的礼拜时间。
• 安装： uvx time-ir-mcp 或 claude mcp add time-ir -- uvx time-ir-mcp。传输方式：stdio。需要 uv（Python 3.10+）。
• 身份验证： 无。可选配置 TIME_IR_MCP_PROXY（HTTP 代理 URL，或以逗号分隔的列表）；系统代理设置会被忽略。
• 访问权限： 只读。不会在任何地方写入数据，因此调用任何工具前都无需确认。
• 工具： 共 13 个，名称均以 ti_ 开头。常见调用顺序：ti_today；ti_events（是否为节假日？）；ti_upcoming_holidays；ti_cities -> ti_prayer_times。
• 适用场景： 用户询问伊朗的日期、伊朗历（شمسی）、格里高利历（میلادی）和回历（قمری）之间的日期转换、某日是否为官方节假日、某日有哪些纪念日、下一个节假日的日期，或伊朗城市的宣礼时间。
• 不适用场景： 用户询问其他国家的节假日或时间（Time.ir 仅涵盖伊朗官方历法）。
• 输出： 紧凑的 JSON。日期采用伊朗历、格里高利历和回历的 YYYY-MM-DD 字符串格式；时间为伊朗当地时间（24 小时制）。标题和描述为波斯语，与 Time.ir 提供的内容一致。

工具

工具	功能
ti_today	获取今天的波斯历、格里历和伊斯兰历日期，以及德黑兰时间、星期、星座和今日事件
ti_convert_date	使用 time.ir 自有的转换器，在波斯历、格里历和伊斯兰历之间转换日期
ti_month	显示一个波斯历月份：对应的格里历和伊斯兰历日期范围、1 日的星期、节假日、周五和所有事件
ti_events	列出某一天的纪念日和法定节假日；如果 time.ir 提供了简短说明，也会一并列出
ti_holidays	列出一个波斯历年份的所有法定节假日，以及对应的格里历和伊斯兰历日期
ti_upcoming_holidays	列出伊朗接下来的法定节假日及距每个节假日的天数
ti_prayer_times	获取伊朗某城市今天的礼拜时间（晨礼、日出、晌礼、日落、昏礼、伊斯兰午夜、白昼时长）
ti_cities	列出伊朗的省份，或某个省的城市，并提供礼拜工具所需的 ID
ti_on_this_day	从 time.ir 的今日页面列出今天的历史事件，以及知名人士的出生和逝世信息
ti_search_events	按关键词、节假日标记或历法搜索一个波斯历年份的所有纪念日
ti_date_difference	计算两个日期之间的天数，并给出波斯历年、月、日（年龄计算器）
ti_long_weekends	查找一个波斯历年份中连续的休息日（节假日加周五）
ti_qibla	获取伊朗某城市到麦加的朝向角度和距离（根据该网站的坐标计算）

全部 13 个工具均标注为 readOnlyHint: true。

快速开始

你需要 uv。无需 API 密钥或账户。

claude mcp add time-ir -- uvx time-ir-mcp

Claude Desktop、Cursor、Windsurf 和 Gemini CLI 使用相同的 stdio 配置：

{
  "mcpServers": {
    "time-ir": { "command": "uvx", "args": ["time-ir-mcp"] }
  }
}

示例提示词：“今天的波斯历日期是什么？”，“12 月 25 日在伊朗是节假日吗？”，“下一个法定节假日是什么时候？” “将 1405-01-01 转换为格里历和伊斯兰历日期。”“今天马什哈德的宣礼时间是什么？” «تاریخ امروز به شمسی چیست؟»، «اذان ظهر شیراز چه ساعتی است؟»، «تعطیلات رسمی بهمن ۱۴۰۵ کدام‌اند؟»

工作原理

time-ir-mcp 在本地运行，并调用 time.ir 页面调用的相同“服务器操作”（www.time.ir 是一个 Next.js 应用； 该网站的服务器使用自己的密钥读取 api.time.ir，而本服务无法获取该密钥）。请求通过模拟 Chrome 的客户端发送， 间隔至少一秒，并缓存 10 分钟（当前时间不会缓存），且只发送到 www.time.ir。网站重新部署时，操作 ID 会变化；如果网站拒绝某个 ID， 服务会在该网站的脚本中按函数名称查找新的 ID，并重试一次。

注意事项

• 仅使用伊朗官方历法。 节假日以伊朗为准；伊斯兰历日期也是伊朗的（可能与沙特阿拉伯相差一天）。不提供世界时钟。
• 周五是周末，但不会单独作为节假日报告；如果周五同时也是纪念日节假日，则会报告。
• 礼拜时间对应给定的波斯历日期（其他历法会先转换），采用伊朗当地时间。非省会城市需要提供 province。
• 波斯语数据。 标题和说明均为波斯语。网站上的事件说明为 HTML；工具会将其转换为纯文本，并截断至 900 个字符。
• 本质上不稳定。 该网站没有公开 API；如果网站页面发生变化，工具可能会失效，直到服务更新为止。

فارسی

开发

uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline tests on recorded time.ir answers
uv run python -m pytest -m live -q  # calls the real time.ir site
uv build

免责声明

本项目为非官方项目，与 Time.ir 或 Radcom 无关联，也未获其认可。本项目仅提供只读功能，使用的是 www.time.ir 的公开页面；这些页面可能会随时更改，恕不另行通知。涉及宗教或法律用途时，请查阅官方来源。

作者

由 Sepehr Radmard（سپهر رادمرد）构建并维护。欢迎通过 LinkedIn 联系，或在 GitHub 上关注 @sepehr071，了解更多面向伊朗网站的 MCP 服务，所有服务均列于 iran-mcp。

许可证

MIT