mcp-todo-server

用于管理 TODO.md 和 CHANGELOG.md 文件的 Model Context Protocol (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 版本的变更日志条目”
• 说“从 /path/to/my/TODO.md 导入我的现有 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 条目

致谢

• tumf/mcp-text-editor 提供了灵感。

许可证

本项目采用 MIT 许可证。详情见 LICENSE。