mcp-todo-server

基本能力

产品定位

mcp-todo-server 是一个专门用于管理项目任务和变更日志的工具，通过 MCP 协议提供高效的文件操作能力。

核心功能

• 精确的行级编辑和读取文件内容。
• 使用行范围高效访问部分文件内容，适用于 LLM 工具。
• 通过指定行范围检索特定文件内容。
• 在单个请求中从多个文件获取多个行范围。
• 应用行级补丁，正确调整行号变化。
• 支持多种字符编码（utf-8、shift_jis、latin1 等）。
• 跨多个文件执行原子操作。
• 使用自定义错误类型进行健壮的错误处理。
• 遵循语义化版本控制和 Keep a Changelog 规范。

适用场景

• 管理项目任务和变更日志。
• 自动化生成变更日志条目。
• 导入和格式化现有的 TODO.md 和 CHANGELOG.md 文件。

工具列表

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 条目。

使用教程

使用依赖

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

安装教程

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

调试方式

安装完成后，可以通过以下命令测试服务是否正常运行：

mcp-todo-server --help

确保服务能够正确响应命令并显示帮助信息。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。