Todo Manager

🚀 mcp-todo-server

模型上下文協議（MCP）服務器，用於管理TODO.md和CHANGELOG.md文件，能高效處理文件編輯、讀取及版本管理等任務。

🚀 快速開始

mcp-todo-server是一個強大的模型上下文協議（MCP）服務器，可用於精確管理TODO.md和CHANGELOG.md文件。通過它，你可以輕鬆實現基於行的文件編輯、讀取以及版本管理等功能。

✨ 主要特性

• 精確的基於行的文件編輯和讀取功能，確保對文件內容的精準操作。
• 高效的部分文件訪問，通過行範圍實現，特別適合大型語言模型工具的使用。
• 可通過指定行範圍獲取特定文件內容，靈活滿足不同需求。
• 支持在單個請求中從多個文件獲取多個行範圍的內容，提高操作效率。
• 應用基於行的補丁，能正確調整行號變化，保證文件內容的一致性。
• 支持廣泛字符編碼（如utf-8、shift_jis、latin1等），適應不同的文件編碼需求。
• 對多文件進行原子操作，確保操作的完整性和一致性。
• 使用自定義錯誤類型實現穩健錯誤處理，增強系統的穩定性。
• 遵循語義化版本控制和保持變更日誌規範，便於項目的版本管理和維護。

📦 安裝指南

安裝要求

• Go語言版本1.23以上
• 支持Linux、macOS或Windows系統
• 文件系統讀寫權限

安裝命令

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

💻 使用示例

基礎用法

• 詢問“當前0.2.0版本的任務有哪些？”
• 指令“在0.2.0版本中添加一個新的任務，實施OAuth認證”
• 請求“根據TODO.md中已完成的任務生成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條目

📄 許可證

本項目採用MIT許可證，詳見LICENSE獲取完整許可文本。

致謝

感謝tumf/mcp-text-editor的啟發。