TODO和CHANGELOG文件管理服务

一个用于管理TODO.md和CHANGELOG.md文件的服务器,支持精确的行级编辑、多文件原子操作和语义化版本控制。

  • by mutker
  • Go
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 mutker/mcp-todo-server

使用说明

mcp-todo服务器

用于管理TODO.md和CHANGELOG.md文件的模型上下文协议(MCP)服务器。

特性

  • 对文件内容进行精确的、基于行的编辑和读取。
  • 使用行范围进行高效的部分文件访问,以实现LLM工具的高效使用。
  • 通过指定行范围检索特定文件内容。
  • 在单个请求中从多个文件中获取多个行范围。
  • 应用基于线条的补丁,正确调整行号更改。
  • 支持多种字符编码(utf-8、shift_jis、latin1等)。
  • 跨多个文件执行原子操作。
  • 使用自定义错误类型进行稳健的错误处理。
  • 遵循语义版本控制并保持变更日志惯例。

需求

  • Go v1.23+
  • Linux、macOS或Windows
  • 读/写操作的文件系统权限

安装

go install codeberg.org/mutker/mcp-todo-server/cmd/mcp-todo-server@latest

使用示例:

  • 询问“0.2.0版本的当前任务是什么?”
  • 说“添加一个新任务以实现0.2.0版本的OAuth身份验证”
  • 请求“根据已完成的任务生成0.1.0版本的变更日志条目”
  • 说“将我现有的TODO.md文件从/path/导入/my/TODO.md”

服务器智能地处理任务解析、版本管理,并提供对任务和变更日志条目的丰富语义理解。

可用的MCP工具

TODO.md操作

  • get-todo-tasks -从TODO.md获取所有任务
  • get-todo-tasks-by-version -获取特定版本的任务
  • add-todo-task -为特定版本添加新任务
  • update-todo-task -更新现有任务
  • add-todo-version -添加新版本部分
  • import-todo -导入并格式化现有TODO.md

CHANGELOG.md操作

  • get-changelog -获取所有更改日志条目
  • get-changelog-by-version -获取特定版本的更新日志条目
  • add-changelog-entry -添加新的更改日志版本条目
  • update-changelog-entry -更新现有的更改日志条目
  • import-changelog -导入并格式化现有的CHANGELOG.md
  • generate-changelog-from-todo -基于TODO.md中已完成的任务生成新的CHANGELOG.md条目

谢谢

许可证

该项目根据MIT许可证获得许可。看 许可证 获取完整的许可证文本。