Todo Manager

A TODO and CHANGELOG file management service based on the MCP protocol

Developer tools Version control #File Management #Task Tracking #Version Log .Go

rating : 2.5 points

downloads : 8.0K

update time : 2025-04-28

Open Site

What is the MCP To-Do Server?

The MCP To-Do Server is an application specifically designed to help you efficiently manage tasks and change logs. It supports precise line-level editing and can intelligently handle task assignment, version control, and generate change log entries.

How to use the MCP To-Do Server?

With simple commands, you can easily add new tasks, update existing tasks, or generate new change log entries. Complex project management tasks can be completed in just a few steps.

Applicable Scenarios

Suitable for enterprises and individual developers who need to continuously track project progress, manage task lists, and record software version updates.

Main Features

Get All Tasks

Extract all to-do items from the TODO.md file.

Get Tasks by Version

Filter relevant to-do items according to a specific version.

Add a New Task

Add a new task record to TODO.md.

Generate Change Log

Automatically generate CHANGELOG.md entries based on completed tasks.

Import an Existing Task List

Import and format an existing task file.

Advantages

Efficient line-level editing reduces redundant operations.

Supports multiple character encodings to ensure cross-platform compatibility.

A powerful error handling mechanism ensures system stability.

Limitations

It has certain requirements for file permissions and may require administrator privileges.

There may be performance bottlenecks for very large files.

How to Use

Install the Server

Use the following command to install the MCP To-Do Server: go install codeberg.org/mutker/mcp-todo-server/cmd/mcp-todo-server@latest

Start the Server

Run the following command in the terminal to start the service: mcp-todo-server start

Usage Examples

Query Tasks of a Specific Version

Users can request to get all tasks in a specific version (e.g., v0.2.0).

Generate Change Log Entries

Users can generate a change log entry based on an existing task list.

Frequently Asked Questions

How to start using the MCP To-Do Server?

Does it support multi-language encoding?

Related Resources

GitHub Repository

The official GitHub repository containing source code and documentation.

Installation Guide

Detailed installation steps.

🚀 mcp-todo-server

The Model Context Protocol (MCP) server is used to manage the TODO.md and CHANGELOG.md files.

🚀 Quick Start

The mcp-todo-server is a Model Context Protocol (MCP) server designed to manage TODO.md and CHANGELOG.md files. It offers a range of features for precise file editing, efficient content access, and robust error handling.

✨ Features

Precise line-based file editing and reading capabilities.
Efficient partial file access through line ranges, suitable for large language model tools.
Retrieve specific file content by specifying line ranges.
Obtain multiple line ranges from multiple files in a single request.
Apply line-based patches and correctly adjust line number changes.
Support a wide range of character encodings (utf-8, shift_jis, latin1, etc.).
Perform atomic operations on multiple files.
Implement robust error handling using custom error types.
Adhere to semantic versioning and maintain a proper change log.

📦 Installation

Requirements

Go version 1.23 or higher
Supported operating systems: Linux, macOS, or Windows
Read and write permissions for the file system

Installation Command

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

💻 Usage Examples

Basic Usage

Query: "What are the tasks for the current 0.2.0 version?"
Instruction: "Add a new task to version 0.2.0 to implement OAuth authentication."
Request: "Generate a change log entry for version 0.1.0 based on the completed tasks in TODO.md."
Command: "Import an existing TODO.md file from /path/to/my/TODO.md."

The server intelligently handles task parsing, version management, and provides a rich understanding of semantic tasks and change log entries.

Available MCP Tools

TODO.md Operations

get-todo-tasks - Retrieve all tasks from TODO.md.
get-todo-tasks-by-version - Retrieve tasks for a specific version.
add-todo-task - Add a new task for a specific version.
update-todo-task - Update an existing task.
add-todo-version - Add a new version section.
import-todo - Import and format an existing TODO.md file.

CHANGELOG.md Operations

get-changelog - Retrieve all change log entries.
get-changelog-by-version - Retrieve change log entries for a specific version.
add-changelog-entry - Add a new change log entry for a version.
update-changelog-entry - Update an existing change log entry.
import-changelog - Import and format an existing CHANGELOG.md file.
generate-changelog-from-todo - Generate new change log entries based on completed tasks in TODO.md.