Weekness — Week & Calendar Utilities

io.github.dvdksn由 GitHub 账号 dvdksn 发布v1.0.0更新于 Oct 24, 2026

MCP server with ISO week and calendar tools for date conversion, week math, and weekday lookups.

已验证STDIO仅桌面效率与工作流

概览

AI 生成的概览

一个 MCP 服务器，为助手提供 ISO 周与日历工具，用于日期转换、周数运算和星期查询。

可以做什么
Weekness 通过 stdio 提供八个小型日历辅助工具：current_date 和 current_week 返回今天的日期、星期名称以及 ISO 周年份、周数和周字符串；timestamp_to_week 将日期或时间戳转换为 ISO 周；week_to_dates 返回某个 ISO 年份和周数对应的周一与周日；add_weeks 按周数前后移动日期或周字符串；weeks_between 计算两个日期之间相隔的周数；weekday_of_date 给出某日期的星期名称；nearest_weekday 查找某个星期几最近一次过去或未来的出现。它接受带时间或时区的 ISO 8601 时间戳、纯日期，以及形如 2024-W15 的 ISO 周字符串。
适用场景
当助手需要可靠的 ISO 周编号而不是靠猜测时适用：例如迭代与报表的周标签、日期与周数之间的换算、围绕某个星期几安排时间，或计算两个日期之间相隔多少周。
运行要求
作为本地 stdio 进程运行。可通过 Docker 从已发布的容器镜像 ghcr.io/dvdksn/weekness:1.0.0 启动，也可用 Go 从源码构建。未声明任何身份验证、环境变量、请求头或网络访问需求。
安装前请注意
该服务器只做日期与周数计算，不读取或修改日历、文件或其他数据。安装意味着运行本地进程或容器，因此对所选镜像或二进制文件仍需保持通常的谨慎。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Weekness — Week & Calendar Utilities，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Weekness MCP Server

An MCP (Model Context Protocol) server that provides week and calendar helper tools for converting between dates and ISO weeks, performing week arithmetic, and looking up weekday names.

Tools

  • current_date: Get today's date (YYYY-MM-DD) and weekday name
  • current_week: Get today's ISO week year, week number, week string, and weekday name
  • timestamp_to_week: Convert a date or timestamp to its ISO week number and week string
  • week_to_dates: Get the Monday start date and Sunday end date for an ISO year and week number
  • add_weeks: Add or subtract weeks from a date or week string
  • weeks_between: Calculate the number of weeks between two dates
  • weekday_of_date: Get the weekday name for a given date
  • nearest_weekday: Find the nearest past or future occurrence of a given weekday

Installation

Docker

bash
docker run --rm -i ghcr.io/dvdksn/weekness:latest

Build from source

bash
go build -o weekness .

Usage

This MCP server communicates over stdio and is designed to be used with MCP clients like Claude Desktop or other applications that support the Model Context Protocol.

Configure in Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

json
{  "mcpServers": {    "weekness": {      "command": "docker",      "args": ["run", "--rm", "-i", "ghcr.io/dvdksn/weekness:latest"]    }  }}

Or if running from a local build:

json
{  "mcpServers": {    "weekness": {      "command": "/path/to/weekness"    }  }}

Supported Timestamp Formats

  • ISO 8601 with time: 2024-03-15T10:30:00Z
  • ISO 8601 with timezone: 2024-03-15T10:30:00-07:00
  • Date only: 2024-03-15
  • ISO week string: 2024-W15 (where accepted)

来源：README.md，提交 9ae1fcb

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。