Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@local-time-mcp What is the current time and Persian date?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
یک سرور MCP (Model Context Protocol) کوچک و قابل اعتماد که به عاملهای هوش مصنوعی اجازه میده زمان و تاریخ دقیق سیستم رو دریافت کنن — شامل تقویم جلالی (هجری شمسی).
🤖 Built with Claude Code — Anthropic's CLI for Claude.
مدلهای زبانی (LLM) ساعت داخلی قابل اعتمادی ندارن. وقتی میپرسید «الان چند ساعته؟»، مدل یا از دادههای آموزشی حدس میزنه یا تاریخ ثابتی از system prompt میخونه — هر دو اشتباهه.
این سرور MCP این مشکل رو حل میکنه با دسترسی مستقیم به ساعت سیستم عامل در لحظه فراخوانی ابزار. هر پاسخ دقیق، بهروز و time-zone-aware هست.
Related MCP server: date
امکان | توضیح |
🌍 هر timezone IANA |
|
⏰ زمان دقیق | تاریخ، ساعت (با ثانیه)، Unix timestamp |
📅 تاریخ جلالی | عددی ( |
🇮🇷 نام روز و ماه فارسی | روز هفته به انگلیسی و فارسی |
🌗 DST خودکار | مدیریت خودکار CET/CEST, EST/EDT و غیره |
🔌 کاملاً آفلاین | فقط از ساعت سیستم استفاده میکنه، بدون اتصال اینترنت |
🪶 وابستگیهای کم | Python 3.11+, MCP SDK, jdatetime, tzdata |
Python 3.11 یا بالاتر
uv (توصیه شده) یا pip
# کلون کردن مخزن
git clone https://github.com/karimi-mohammad/local-time-mcp.git
cd local-time-mcp
# نصب با uv (توصیه شده)
uv pip install -e .
# یا نصب با pip
pip install -e .claude mcp add local-time -s user -- uv run --directory "C:\path\to\local-time-mcp" python -m local_time_mcpsettings.jsonاین محتوا رو به فایل پیکربندی MCP Claude Code اضافه کنید (~/.claude/settings.json یا .claude/settings.json در سطح پروژه):
{
"mcpServers": {
"local-time": {
"command": "uv",
"args": [
"run",
"--directory",
"C:\\path\\to\\local-time-mcp",
"python",
"-m",
"local_time_mcp"
]
}
}
}cd local-time-mcp
pip install -e .{
"mcpServers": {
"local-time": {
"command": "local-time-mcp"
}
}
}get_current_datetimeزمان و تاریخ فعلی رو به صورت JSON ساختاریافته برمیگردونه.
پارامتر | نوع | ضروری | توضیح |
|
| ❌ | نام timezone IANA (مثلاً |
فیلد | نوع | مثال | توضیح |
|
|
| تاریخ و ساعت ISO 8601 با offset |
|
|
| تاریخ میلادی (YYYY-MM-DD) |
|
|
| ساعت (HH:MM:SS) |
|
|
| نام روز به انگلیسی |
|
|
| نام روز به فارسی |
|
|
| نام timezone IANA استفاده شده |
|
|
| اختلاف با UTC (±HH:MM) |
|
|
| Unix epoch timestamp |
|
|
| تاریخ جلالی (YYYY/MM/DD) |
|
|
| تاریخ جلالی به فارسی |
|
|
| سال جلالی |
|
|
| ماه جلالی (1-12) |
|
|
| نام ماه فارسی |
|
|
| روز جلالی (1-31) |
> get_current_datetime()
> get_current_datetime("Asia/Tehran")
> get_current_datetime("Europe/Berlin")
> get_current_datetime("UTC")
> get_current_datetime("America/New_York"){
"datetime": "2026-08-10T14:31:59+03:30",
"date": "2026-08-10",
"time": "14:31:59",
"day_of_week": "Monday",
"day_of_week_fa": "دوشنبه",
"timezone": "Asia/Tehran",
"utc_offset": "+03:30",
"unix_timestamp": 1786359719,
"jalali_date": "1405/05/19",
"jalali_date_fa": "19 مرداد 1405",
"jalali_year": 1405,
"jalali_month": 5,
"jalali_month_name": "مرداد",
"jalali_day": 19
}{
"error": "Invalid timezone: 'Invalid/Zone'. Use IANA format like 'Asia/Tehran', 'UTC', etc."
}علاوه بر MCP server، یک اسکیل CLI مستقل هم وجود داره که مستقیماً از خط فرمان قابل استفاده هست:
# فایلها رو به دایرکتوری skills کپی کنید
cp -r skill/ ~/.claude/skills/local-time/دستور | توضیح | مثال |
| زمان فعلی با تمام جزئیات |
|
| زمان با timezone مشخص |
|
| تاریخ جلالی فعلی |
|
| روز هفته (انگلیسی + فارسی) |
|
| تبدیل میلادی به جلالی |
|
| تبدیل جلالی به میلادی |
|
| Unix timestamp |
|
| لیست timezoneهای رایج |
|
{
"datetime": "2026-08-10T14:31:59.027681+03:30",
"date": "2026-08-10",
"time": "14:31:59",
"day_of_week": "Monday",
"day_of_week_fa": "دوشنبه",
"timezone": "Asia/Tehran",
"utc_offset": "+03:30",
"unix_timestamp": 1786359719,
"jalali_date": "1405/05/19",
"jalali_date_fa": "19 مرداد 1405"
}هر نام timezone IANA معتبر کار میکنه. مثالهای رایج:
Timezone | توضیح | UTC Offset |
| زمان هماهنگ جهانی | +00:00 |
| ساعت ایران | +03:30 |
| ساعت مرکز اروپا (CET/CEST) | +01:00 / +02:00 |
| ساعت شرق آمریکا (EST/EDT) | -05:00 / -04:00 |
| ساعت اقیانوس آرام (PST/PDT) | -08:00 / -07:00 |
| ساعت ژاپن | +09:00 |
| ساعت بریتانیا (GMT/BST) | +00:00 / +01:00 |
| ساعت امارات | +04:00 |
Claude (یا هر عامل هوش مصنوعی متصل) باید در موارد زیر get_current_datetime رو فراخوانی کنه:
🕐 زمان یا تاریخ فعلی
📆 روز هفته
📛 "امروز"، "فردا"، "دیروز"
⏳ مهلتها یا استدلالهای حساس به زمان
📊 تاریخهای نسبی ("۲ روز دیگه")
🔄 هر عملیاتی که دقت در اون مهمه
از حدس زدن تاریخ/ساعت از context مدل استفاده نکنید. همیشه این ابزار رو فراخوانی کنید.
local-time-mcp/
├── pyproject.toml # پیکربندی پکیج
├── README.md # این فایل
├── LICENSE # مجوز MIT
├── src/
│ └── local_time_mcp/
│ ├── __init__.py
│ ├── __main__.py # python -m local_time_mcp
│ └── server.py # پیادهسازی سرور MCP
├── skill/
│ ├── SKILL.md # مستندات اسکیل CLI
│ └── local_time.py # اسکریپت CLI
└── tests/
├── __init__.py
└── test_server.py # ۴۴ تست# نصب وابستگیهای توسعه
uv pip install -e ".[dev]"
# اجرای تمام تستها
pytest
# اجرای با جزئیات
pytest -v
# اجرای یک کلاس تست خاص
pytest tests/test_server.py::TestJalaliDate -vکلاس تست | تعداد | توضیح |
| ۶ | timezone محلی سیستم |
| ۳ | timezone آسیا/تهران |
| ۳ | timezone DST-aware |
| ۳ | timezone UTC |
| ۲ | timezone EST/EDT |
| ۳ | مدیریت خطا |
| ۴ | نام روز انگلیسی و فارسی |
| ۳ | محاسبات offset |
| ۲ | دقت timestamp |
| ۲ | بهروزرسانی بلادرنگ |
| ۳ | wrapper ابزار MCP |
| ۱۰ | تبدیل تقویم جلالی |
مجموع | ۴۴ |
# ۱. بررسی نسخه Python
python --version
# ۲. نصب مجدد وابستگیها
uv pip install -e .
# ۳. تست مستقیم سرور
python -m local_time_mcpاز نامهای timezone IANA معتبر استفاده کنید:
✅ درست | ❌ غلط |
|
|
|
|
|
|
|
|
سرور روی Windows 10+ با Python 3.11+ کار میکنه
داده timezone از طریق ماژول zoneinfo پایتون در دسترسه
نیازی به پایگاه داده timezone اضافی نیست
Get the current date and time.
Returns structured JSON with the current datetime, including:
ISO 8601 datetime string
Date (YYYY-MM-DD)
Time (HH:MM:SS)
Day of week in English and Persian
IANA timezone name
UTC offset
Unix timestamp
Jalali (Solar Hijri) date in numeric and Persian formats
Args: timezone: Optional IANA timezone name (e.g., "Asia/Tehran", "Europe/Berlin", "America/New_York", "UTC"). If not provided, uses system local timezone.
Returns: JSON string with datetime information, or error message for invalid timezone.
Examples: - get_current_datetime() -> Current time in system timezone - get_current_datetime("Asia/Tehran") -> Current time in Tehran - get_current_datetime("UTC") -> Current time in UTC
| Name | Required | Description | Default |
|---|---|---|---|
| timezone | No |
| Name | Required | Description |
|---|---|---|
| result | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden of behavioral disclosure. It thoroughly explains the return format (fields like ISO 8601, Jalali date, timezone info) and mentions error behavior for invalid timezone. This covers the tool's observable behavior well for a read-only utility.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured with a summary, bulleted return fields, Args section, and examples. While slightly long, every section adds value and the structure aids scanning. No fluff or redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-parameter tool with no siblings and no annotations, this description is fully complete. It covers purpose, parameters, return format, error handling, and examples. The output schema is described in detail, so an agent knows exactly what to expect.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema provides only the name 'timezone' with no description (0% coverage). The description compensates fully: it explains the purpose, lists valid IANA examples, documents the default behavior, and provides usage examples. This adds complete semantic meaning beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description starts with a clear verb-object statement: 'Get the current date and time.' It then enumerates the exact data returned, making the tool's functionality unambiguous. No siblings exist, so distinction is automatically satisfied.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description states when to use the optional timezone parameter and what happens if it's omitted ('If not provided, uses system local timezone'). Examples cover typical use cases. No exclusions or alternatives are needed since there are no sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
v0.1.0get_current_datetimeScored across 1 tool
Only a single tool exists, so there is no possibility of overlap or confusion. The tool's purpose is clearly defined.
The single tool follows a clear verb_noun pattern (get_current_datetime), which is consistent and descriptive.
With only 1 tool, the server feels thin even for a focused time utility. However, the tool provides comprehensive datetime information, making the single tool non-trivial.
For its scope (returning current datetime with optional timezone), the tool fully covers the domain. It returns all relevant fields including ISO, date, time, day of week, timezone, offset, Unix timestamp, and Jalali date.
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
A real clock for AI agents: current time, timezone conversion, and DST facts from the IANA tzdb.
Current time, timezone conversion & date math for AI agents. On Cloudflare Workers.
A time server that keeps your AI honest about time. Real clock + drift guard, zero dependencies.
Timezone MCP — wraps WorldTimeAPI (free, no auth)
