mcpField
W
Weekness — Week & Calendar Utilities

Weekness — Week & Calendar Utilities

本地服务
github.com/dvdksn生产力021 周前更新
代码仓库

关于 Weekness — Week & Calendar Utilities

Weekness 是用于 ISO 周日期与日历计算的 MCP 服务，为需要周次转换、周数运算和星期查询的应用与用户提供工具。

主要功能

  1. 01获取今天的日期和星期
  2. 02获取当前 ISO 周
  3. 03将日期和时间戳转换为 ISO 周
  4. 04查询 ISO 周对应的日期范围
  5. 05增加或比较周数
  6. 06查询星期或查找最近星期

适用场景

  1. 01将时间戳转换为 ISO 周
  2. 02查询某周从周一到周日的日期
  3. 03计算两个日期相隔的周数
  4. 04查找最近一次或下一次指定星期

MCP 相关

通过 stdio 向 MCP 客户端提供日期、ISO 周和星期查询工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "dvdksn-weekness": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/dvdksn/weekness:1.0.0"
      ]
    }
  }
}
启动命令docker run -i --rm ghcr.io/dvdksn/weekness:1.0.0

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
ocighcr.io/dvdksn/weekness:1.0.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Weekness MCP Server

一个 MCP（Model Context Protocol）服务，提供周和日历辅助工具，用于在日期与 ISO 周之间转换、进行周数运算，以及查询星期名称。

工具

  • current_date：获取今天的日期（YYYY-MM-DD）和星期名称
  • current_week：获取今天所属的 ISO 周年、周数、周字符串和星期名称
  • timestamp_to_week：将日期或时间戳转换为 ISO 周数和周字符串
  • week_to_dates：获取指定 ISO 周年和周数对应的周一开始日期和周日结束日期
  • add_weeks：对日期或周字符串增加或减少周数
  • weeks_between：计算两个日期之间的周数
  • weekday_of_date：获取指定日期的星期名称
  • nearest_weekday：查找指定星期最近的过去或未来日期

安装

Docker
docker run --rm -i ghcr.io/dvdksn/weekness:latest
从源代码构建
go build -o weekness .

用法

此 MCP 服务通过 stdio 通信，旨在与 Claude Desktop 等 MCP 客户端或其他支持 Model Context Protocol 的应用程序配合使用。

在 Claude Desktop 中配置

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

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

或者，如果从本地构建版本运行：

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

支持的时间戳格式

  • 带时间的 ISO 8601：2024-03-15T10:30:00Z
  • 带时区的 ISO 8601：2024-03-15T10:30:00-07:00
  • 仅日期：2024-03-15
  • ISO 周字符串：2024-W15（适用于接受此格式的情况）

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。