Skip to main content
Glama
xiaobenyang-com

time-mcp

时间感知服务器

Time MCP Server是一个为大型语言模型提供时间感知能力的服务器实现,支持获取当前时间、相对时间、时间戳转换等功能。 Time MCP Server is a server implementation that provides time aware capabilities for large language models, supporting functions such as obtaining current time, relative time, and timestamp conversion.## 工具列表 Tool List

本MCP服务封装下列工具,可让模型通过标准化接口调用以下功能。 本MCP服务封装下列工具,可让模型通过标准化接口调用以下功能。

工具 Tool

描述 Description

current_time

Get the current date and time.

relative_time

Get the relative time from now.

days_in_month

Get the number of days in a month. If no date is provided, get the number of days in the current month.

get_timestamp

Get the timestamp for the time.

convert_time

Convert time between timezones.

get_week_year

Get the week and isoWeek of the year.

检查服务 ## Inspector

工具在线测试: https://mcp.xiaobenyang.com/inspector/1777316659687427

Online Tool test https://mcp.xiaobenyang.com/inspector/1777316659687427

Related MCP server: Temporal Awareness MCP Server

服务配置 MCP Server Config

如何获取 XBY-APIKEY ? How to get XBY-APIKEY ?

访问小笨羊科技网站 https://xiaobenyang.com,注册用户即可获得APIKEY Visit XiaoBenYang website https://xiaobenyang.com, register and get the APIKEY.

SSE

{
  "mcpServers": {
    "时间感知服务器": {
      "headers": {
        "XBY-APIKEY": "<YOUR_XBY_APIKEY>"
      },
      "type": "sse",
      "url": "https://mcp.xiaobenyang.com/1777316659687427/sse"
    }
  }
}

STREAMABLE HTTP

{
  "mcpServers": {
    "时间感知服务器": {
      "headers": {
        "XBY-APIKEY": "<YOUR_XBY_APIKEY>"
      },
      "type": "streamable_http",
      "url": "https://mcp.xiaobenyang.com/1777316659687427/mcp"
    }
  }
}

STDIO

{
    "mcpServers": {
        "时间感知服务器": {
          "command": "npx",
          "args": [
            "-y",
            "xiaobenyang-mcp"
          ],
          "env": {
            "XBY_APIKEY": "<YOUR_XBY_APIKEY>",
            "mcpId": "1777316659687427",
          },
          "transport": "stdio"
        }
      }
}

Available Tools

6 tools
convert_timeconvert_timeC

Convert time between timezones.

ParametersJSON Schema
NameRequiredDescriptionDefault
sourceTimezoneYes
targetTimezoneYes
timeYes

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It only states the basic function without detailing behavioral traits like error handling (e.g., invalid timezone inputs), rate limits, or response format. This leaves significant gaps in understanding how the tool behaves beyond its core purpose.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise with a single sentence: 'Convert time between timezones.' It is front-loaded and wastes no words, making it easy to grasp quickly. Every word earns its place by directly stating the tool's function.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (time conversion with 3 parameters), lack of annotations, no output schema, and 0% schema description coverage, the description is incomplete. It doesn't provide enough context for effective use, such as parameter formats, return values, or error conditions, leaving users with insufficient information.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 3 parameters with 0% description coverage, meaning no parameter details are provided in the schema. The description does not add any meaning beyond the schema; it doesn't explain what 'sourceTimezone', 'targetTimezone', or 'time' represent (e.g., format, examples, or constraints). This fails to compensate for the low schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Convert time between timezones.' It specifies the verb 'convert' and the resource 'time,' making it understandable. However, it doesn't differentiate from sibling tools like 'current_time' or 'relative_time,' which also handle time-related operations, so it lacks sibling distinction.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention when to choose 'convert_time' over sibling tools such as 'relative_time' for time calculations or 'current_time' for current time retrieval, nor does it specify any prerequisites or exclusions for usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

current_timecurrent_timeC

Get the current date and time.

ParametersJSON Schema
NameRequiredDescriptionDefault
formatYes
timezoneNo

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It states the tool 'gets' data, implying a read-only operation, but doesn't address potential behaviors like rate limits, authentication needs, error conditions, or what happens with invalid inputs. This leaves significant gaps for a tool with parameters.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence with zero wasted words. It's appropriately sized for a simple tool and front-loads the essential information, making it easy to parse quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 2 parameters with 0% schema coverage and no output schema, the description is incomplete. It doesn't explain parameter usage, return values, or behavioral constraints, making it inadequate for an agent to use the tool correctly without additional context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 0%, so the description must compensate for undocumented parameters. It mentions no parameters at all, failing to explain what 'format' and 'timezone' do, their expected values, or how they affect the output. This leaves both parameters completely unexplained.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Get') and resource ('current date and time'), making the purpose immediately understandable. However, it doesn't differentiate from sibling tools like 'get_timestamp' or 'get_week_year' which may also retrieve time-related information, so it doesn't reach the highest score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like 'get_timestamp' or 'convert_time'. It lacks context about specific use cases or exclusions, leaving the agent to infer usage based on tool names alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

days_in_monthdays_in_monthA

Get the number of days in a month. If no date is provided, get the number of days in the current month.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateNo

TDQS

A4.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It explains the tool's behavior (defaulting to current month if no date is given), which is useful, but does not cover aspects like error handling, date format requirements, or performance traits. This leaves gaps in transparency for a tool with no structured annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the core purpose in the first sentence and adds necessary detail in the second, with no wasted words. Both sentences earn their place by clarifying behavior and default usage, making it efficient and well-structured.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's low complexity (one optional parameter, no annotations, no output schema), the description is mostly complete for basic usage. However, it lacks details on the return value (e.g., integer output) and potential edge cases (e.g., invalid dates), which would enhance completeness for a tool with no output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 0% description coverage for the single parameter 'date', but the description compensates by explaining its optional nature and effect (if provided, uses that month; if not, uses current month). This adds meaningful context beyond the bare schema, though it does not specify the expected date format or validation rules.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the specific action ('Get the number of days in a month') and the resource involved ('a month'), distinguishing it from sibling tools like 'convert_time' or 'current_time' which handle different time-related operations. It also specifies the behavior when no date is provided, making the purpose unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear context for when to use the tool (to get days in a month, with or without a date input), but it does not explicitly state when not to use it or name alternatives among siblings like 'get_week_year' for different time calculations. This gives adequate guidance but lacks exclusion details.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_timestampget_timestampD

Get the timestamp for the time.

ParametersJSON Schema
NameRequiredDescriptionDefault
timeNo

TDQS

D1.5/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. However, it reveals nothing about behavioral traits: it doesn't indicate whether this is a read-only operation, if it has side effects, what format the output might be in, or any error conditions. The description is too vague to inform the agent about how the tool behaves beyond the basic action implied by the name.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise with a single sentence, but it's under-specified rather than efficiently informative. While it's front-loaded (the entire description is one line), it fails to earn its place by adding value beyond the tool name. The brevity here is a detriment due to lack of content, not an asset of clear communication.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has one parameter with no schema descriptions, no annotations, and no output schema, the description is completely inadequate. It doesn't explain what the tool does in detail, how to use the parameter, what the output might be, or how it differs from siblings. For a tool with such minimal structured data, the description should provide comprehensive context, which it fails to do.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has one parameter ('time') with 0% description coverage, meaning the schema provides no semantic information. The description does not compensate by explaining what the 'time' parameter represents (e.g., a date-time string, a time zone, a specific format) or how it's used. Without this, the agent cannot understand what input to provide, leading to potential misuse.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Get the timestamp for the time' is tautological, essentially restating the tool name 'get_timestamp' without adding meaningful specificity. It doesn't clarify what resource is being acted upon (e.g., converting a time string to Unix timestamp, extracting timestamp from a date object) or distinguish it from sibling tools like 'convert_time' or 'current_time'. The verb 'get' is generic and the phrase 'for the time' is circular.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention sibling tools like 'convert_time' or 'current_time', nor does it specify any context, prerequisites, or exclusions for usage. Without any usage instructions, an AI agent would have to guess based on the tool name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_week_yearget_week_yearC

Get the week and isoWeek of the year.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateNo

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It states what the tool does but fails to describe key traits such as whether it's read-only, what format the output returns, error handling, or any constraints. This leaves significant gaps in understanding how the tool behaves beyond its basic function.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise with a single sentence that directly states the tool's purpose without any unnecessary words. It is front-loaded and efficient, making it easy to parse quickly, which is ideal for clarity in tool selection.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of annotations, no output schema, and incomplete parameter documentation, the description is insufficient for a tool that performs date calculations. It should explain the return format, input date format expectations, and any behavioral nuances to be considered complete for effective use by an AI agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description does not mention the 'date' parameter at all, and with 0% schema description coverage, the parameter is undocumented in both the schema and description. However, since there is only one parameter, the baseline is higher, but the description adds no value beyond what the schema minimally provides, resulting in an average score.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Get' and the specific resources 'week and isoWeek of the year', making the purpose immediately understandable. However, it doesn't explicitly differentiate from sibling tools like 'get_timestamp' or 'current_time' that might also provide time-related information, preventing a perfect score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like 'get_timestamp' or 'current_time'. It lacks context about typical use cases, prerequisites, or exclusions, leaving the agent to infer usage based solely on the tool name and purpose.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

relative_timerelative_timeC

Get the relative time from now.

ParametersJSON Schema
NameRequiredDescriptionDefault
timeYes

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It states the tool 'Get[s] the relative time from now', implying a read-only operation, but doesn't specify details like input format (e.g., ISO 8601), error handling, or output structure. This leaves significant gaps in understanding how the tool behaves beyond its basic purpose.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise with a single sentence ('Get the relative time from now.'), which is front-loaded and wastes no words. It efficiently communicates the core purpose without unnecessary elaboration.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (1 parameter, no annotations, no output schema), the description is incomplete. It doesn't explain what 'relative time' means in practice, how the 'time' parameter should be formatted, or what the output looks like (e.g., a string like '2 hours ago'). This leaves the agent with insufficient context to use the tool effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 1 parameter ('time') with 0% description coverage, meaning the schema provides no details about its meaning or format. The description adds no parameter-specific information beyond implying it relates to 'time', failing to compensate for the low schema coverage. This leaves the parameter's semantics largely undefined.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Get the relative time from now' clearly states the tool's function with a specific verb ('Get') and resource ('relative time'), but it's somewhat vague about what 'relative time' means compared to siblings like 'convert_time' or 'get_timestamp'. It doesn't explicitly distinguish itself from these alternatives, leaving room for ambiguity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus siblings such as 'convert_time' or 'get_timestamp'. The description lacks context about use cases, prerequisites, or exclusions, leaving the agent to infer usage based on the tool name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 6 tool updatesv1.0.0
    • First observedconvert_time
    • First observedcurrent_time
    • First observeddays_in_month
    • First observedget_timestamp
    • First observedget_week_year
    • First observedrelative_time

TDQS

B3/5.0

Scored across 6 tools

Disambiguation5/5

Each tool has a clearly distinct purpose with no overlap: converting timezones, getting current time, calculating days in a month, generating timestamps, determining week/year, and computing relative time. The descriptions are specific enough to prevent confusion between tools.

Naming Consistency4/5

Most tools follow a consistent verb_noun pattern (e.g., convert_time, get_timestamp), but 'current_time' and 'relative_time' deviate slightly by using adjectives instead of verbs. The naming is still readable and predictable overall.

Tool Count5/5

With 6 tools, the server is well-scoped for time-related operations. Each tool serves a unique and useful function, avoiding bloat while covering common time manipulation needs effectively.

Completeness4/5

The toolset covers core time operations like conversion, current time, and relative calculations, but lacks explicit CRUD for time data (e.g., scheduling or event management). Minor gaps exist, but agents can work around them for most time-related tasks.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

  • The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.

  • The Remote MCP server acts as a standardized bridge between LLM applications (like Claude, ChatGPT, and Cursor) and external services, enabling AI agents to access external tools and resources. Its primary capability is providing a centralized search tool to discover other MCP servers and their respective tools. Unlike local implementations, it runs remotely with OAuth authentication and permission controls for security.

  • MCP server providing access to the Scorecard API to evaluate and optimize LLM systems.

  • MCP server for AI dialogue using various LLM models via AceDataCloud

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    The Time MCP Server is a Model Context Protocol (MCP) server that provides AI assistants and other MCP clients with standardized tools to perform time and date-related operations. This server acts as a bridge between AI tools and a robust time-handling back
    43 npm
    25
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server that provides AI agents with comprehensive temporal awareness and time calculation capabilities.
    3
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    A general-purpose MCP server providing time-related utilities such as fetching current time, Unix timestamps, and formatting services. It supports both local stdio and remote SSE communication modes for versatile AI client integration.
    3
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Lightweight MCP server providing system time tools (current time, date, datetime, time components, unix timestamp) for LLM applications.
    1
    MIT