FinanceMCP

Instructions

Implementation Reference

• src/index.ts:44-108 (handler)

  The core handler function for the 'current_timestamp' tool. It computes the current time in China timezone (UTC+8), supports formatting options (datetime, date, time, timestamp, readable), includes Chinese weekday, returns structured MCP content with markdown, and handles errors.

  async run(args?: { format?: string }) {
    try {
      // 获取当前UTC时间
      const now = new Date();
      
      // 转换为东八区时间（UTC+8）
      const chinaTime = new Date(now.getTime() + (8 * 60 * 60 * 1000));
      
      const format = args?.format || 'datetime';
      
      // 格式化时间函数
      const formatNumber = (num: number): string => num.toString().padStart(2, '0');
      
      const year = chinaTime.getUTCFullYear();
      const month = formatNumber(chinaTime.getUTCMonth() + 1);
      const day = formatNumber(chinaTime.getUTCDate());
      const hour = formatNumber(chinaTime.getUTCHours());
      const minute = formatNumber(chinaTime.getUTCMinutes());
      const second = formatNumber(chinaTime.getUTCSeconds());
      
      // 星期几
      const weekdays = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'];
      const weekday = weekdays[chinaTime.getUTCDay()];
      
      let result: string;
      
      switch (format) {
        case 'date':
          result = `${year}-${month}-${day}`;
          break;
        case 'time':
          result = `${hour}:${minute}:${second}`;
          break;
        case 'timestamp':
          result = Math.floor(chinaTime.getTime() / 1000).toString();
          break;
        case 'readable':
          result = `${year}年${month}月${day}日 ${weekday} ${hour}时${minute}分${second}秒`;
          break;
        case 'datetime':
        default:
          result = `${year}-${month}-${day} ${hour}:${minute}:${second}`;
          break;
      }
      
      return {
        content: [
          {
            type: "text",
            text: `## 🕐 当前东八区时间\n\n格式: ${format}\n时间: ${result}\n\n时区: 东八区 (UTC+8)\n星期: ${weekday}\n\n---\n\n*时间戳获取于: ${year}-${month}-${day} ${hour}:${minute}:${second}*`
          }
        ]
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text", 
            text: `❌ 获取时间戳时发生错误: ${error instanceof Error ? error.message : String(error)}`
          }
        ],
        isError: true
      };
    }
  }

• src/index.ts:35-42 (schema)

  Input schema for the current_timestamp tool, defining an optional 'format' parameter as string with description of supported formats.

  parameters: {
    type: "object",
    properties: {
      format: {
        type: "string",
        description: "时间格式，可选值：datetime(完整日期时间，默认)、date(仅日期)、time(仅时间)、timestamp(Unix时间戳)、readable(可读格式)"
      }
    }

• src/index.ts:228-231 (registration)

  Registration/dispatch in the CallToolRequestSchema handler: extracts 'format' argument and calls the tool's run method.

  case "current_timestamp": {
    const format = request.params.arguments?.format ? String(request.params.arguments.format) : undefined;
    return await timestampTool.run({ format });
  }

• src/httpServer.ts:39-57 (handler)

  Compact version of the core handler function for HTTP server, identical logic to stdio version but simplified response without error handling or full weekday in output.

  async run(args?: { format?: string }) {
    const now = new Date();
    const chinaTime = new Date(now.getTime() + (8 * 60 * 60 * 1000));
    const format = args?.format || 'datetime';
    const pad = (n: number) => n.toString().padStart(2, '0');
    const y = chinaTime.getUTCFullYear();
    const m = pad(chinaTime.getUTCMonth() + 1);
    const d = pad(chinaTime.getUTCDate());
    const hh = pad(chinaTime.getUTCHours());
    const mm = pad(chinaTime.getUTCMinutes());
    const ss = pad(chinaTime.getUTCSeconds());
    const weekdays = ['星期日','星期一','星期二','星期三','星期四','星期五','星期六'];
    const wd = weekdays[chinaTime.getUTCDay()];
    let result = `${y}-${m}-${d} ${hh}:${mm}:${ss}`;
    if (format === 'date') result = `${y}-${m}-${d}`;
    if (format === 'time') result = `${hh}:${mm}:${ss}`;
    if (format === 'timestamp') result = Math.floor(chinaTime.getTime()/1000).toString();
    if (format === 'readable') result = `${y}年${m}月${d}日 ${wd} ${hh}时${mm}分${ss}秒`;
    return { content: [{ type: 'text', text: `## 🕐 当前东八区时间\n\n格式: ${format}\n时间: ${result}\n星期: ${wd}` }] };

• src/httpServer.ts:246-247 (registration)

  Dispatch case in the HTTP /mcp POST tools/call handler for current_timestamp.

  case 'current_timestamp':
    return await timestampTool.run({ format: args?.format ? String(args.format) : undefined });