mcp-cronos Skill 技能

技能简介

mcp-cronos 是一款基于 Model Context Protocol（MCP）的结构化工作日记管理服务器。它将程序员的日常工作日志——包括每日记录、站会摘要、周报、阻塞项管理、全文搜索和 Git 提交——全部纳入 AI 代理可读的标准化结构，让 Claude、Cursor、Codex 等编码代理能够在开发会话中随时查阅、调取和更新你的工作上下文。与传统笔记工具不同，mcp-cronos 从一开始就是为 AI 协作设计的：代理不仅能读取你的工作记录，还能通过 MCP 协议写入新条目、生成摘要和执行 Git 操作，真正成为你日常开发流程的一部分。

核心能力

1. 结构化日记条目管理：自动按日期创建目录和文件，支持添加工作记录、阻塞项（Blocker）和项目子条目，所有内容以 Markdown 格式持久化，AI 代理可直接读取和追加内容。
2. 站会摘要生成：一句话生成当日工作叙事性摘要，输出格式经过结构化整理，可直接复制到 Slack、飞书、Teams 等协作工具中使用，无需手动整理。
3. 周报自动汇总：按项目分组，自动汇总本周所有工作条目，生成结构化周报，方便管理者查阅或归档。
4. 全文正则搜索：支持正则表达式（Regex）模式搜索历史日记条目，快速定位某条特定记录或代码修改背景。
5. Git 自动提交：end-of-day 工作流支持自动将当日日记 commit 到 Git 仓库（可选 push），保证工作记录与代码版本同步留存。
6. 阻塞项（Blocker）管理：随时为某天日记添加/更新阻塞项，记录当前面临的问题和障碍，供后续复盘使用。
7. 国际化支持：内置意大利语和英语语言包，通过 cronos.toml 配置文件切换，适合国际化团队使用。

安装配置

1. pip 安装（需要 Python 3.10+）：

   pip install mcp-cronos

   或使用 uvx 无安装运行：

   uvx mcp-cronos

2. 配置文件创建：在项目根目录或 ~/.config/cronos/ 下创建 cronos.toml，可配置语言、日记根目录路径、Git 自动提交行为等参数。

3. MCP 客户端配置：在 Claude Code、Cursor、Windsurf 等支持 MCP 的编辑器中，添加服务器配置（stdio 模式），或通过 MCP 客户端工具直接连接。

4. 环境变量配置（可选）：通过环境变量设置日记根目录路径、Cronos API Token（未来功能）等。

使用步骤

1. 初始化日记结构：首次运行时，mcp-cronos 会根据当前日期自动在指定目录下创建 YYYY/MM/DD 的层级目录结构，无需手动建文件夹。

2. 添加每日工作条目：使用 add 工具添加工作条目，系统自动在当日目录下生成带时间戳的 Markdown 文件，同时记录所属项目、Git 分支和 Jira ticket 等元信息。

3. 生成站会摘要：在晨会前调用 standup 工具，mcp-cronos 会读取近 N 天日记内容，生成一段叙事性摘要，涵盖做了什么、遇到什么 blockers、接下来计划，格式整洁可直接分享。

4. 结束日工作流：收工时调用 end-of-day 工具，自动重写整理当日条目、生成技术总结和站会消息，并可选触发 Git commit 保留当日记录。

5. 查询历史记录：使用 search 工具按日期范围或正则模式搜索历史条目；使用 weekly-report 按项目维度汇总本周工作。

适用场景

1. AI 编程代理协作：当你使用 Claude Code、Cursor 等 AI 编码代理时，代理可以通过 MCP 读取你之前的工作记录，了解当前项目的上下文和历史决策，避免重复讨论已确定的方案。
2. 远程团队站会：每日起草站会汇报内容耗时，mcp-cronos 自动从你的工作日记中提取要点生成摘要，节省时间同时确保信息不遗漏。
3. 项目复盘与知识积累：遇到阻塞项后记录下来，mcp-cronos 在周报和月视图中清晰呈现你踩过的坑，形成可检索的项目经验知识库。
4. 代码审查上下文传递：当你需要换人或跨团队交接时，日记中记录的 branch、Jira ticket、GitHub MR 等元信息让接手人快速了解背景。
5. 个人工作日志归档：不想用第三方笔记服务，希望自托管纯 Markdown 文件管理日记，mcp-cronos 提供了 AI 友好的结构化方案。

适用人群

• 使用 Claude Code、Cursor、Windsurf、Codex 等 AI 编码代理的开发者
• 需要每日站会汇报的敏捷团队成员
• 希望建立可检索工作日志的个人开发者
• 需要为 AI 代理提供长期上下文的项目团队
• 使用 Git 管理项目、重视工作记录与代码版本同步的技术人员

工作原理

mcp-cronos 基于 MCP（Model Context Protocol）协议实现，运行一个本地 MCP 服务器，监听来自 AI 客户端的 STDIO 连接。服务器将工作日记存储在本地文件系统（默认路径可配置），以 YYYY/MM/DD 层级目录组织，每个条目为 Markdown 文件，包含创建时间、所属项目、抗生素元数据等 YAML front matter。

当 AI 代理通过 MCP 协议调用工具（如 add_entry、standup_summary、search）时，服务器在本地文件系统上执行对应操作（读写文件、执行 Git 命令），并返回结构化结果。协议层负责序列化和传输，全程无需联网（离线可用），数据完全自托管。

官方链接

• PyPI 主页：https://pypi.org/project/mcp-cronos/
• GitHub 仓库：https://github.com/mauriziomocci/mcp-cronos
• MCP 官方协议：https://modelcontextprotocol.io