mcp-todo-server

mutker/mcp-todo-server

3.3

If you are the rightful owner of mcp-todo-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Model Context Protocol (MCP) server is designed for managing TODO.md and CHANGELOG.md files with precision and efficiency.

The MCP-TODO-Server is a specialized server application that facilitates the management of TODO.md and CHANGELOG.md files. It offers precise, line-based editing and reading capabilities, allowing users to efficiently access and modify file contents. The server supports a wide range of character encodings and provides robust error handling through custom error types. It adheres to Semantic Versioning and Keep a Changelog conventions, ensuring that version management and changelog entries are handled consistently. The server is built with Go and is compatible with Linux, macOS, and Windows platforms, requiring appropriate file system permissions for read/write operations. With its intelligent task parsing and version management, the MCP-TODO-Server provides a rich semantic understanding of tasks and changelog entries, making it an invaluable tool for developers and project managers.

Features

  • Precise, line-based editing and reading of file contents.
  • Efficient partial file access using line ranges.
  • Supports a wide range of character encodings.
  • Robust error handling with custom error types.
  • Adheres to Semantic Versioning and Keep a Changelog conventions.

Usages

local integration stdio

python
mcp.run(transport='stdio')  # Tools defined via @mcp.tool() decorator

local integration ide plugin

{
  "mcpServers": {
    "todo": {
      "command": "go",
      "args": ["run", "codeberg.org/mutker/mcp-todo-server/cmd/mcp-todo-server"]
    }
  }
}

remote integration sse

python
mcp.run(transport='sse', host="0.0.0.0", port=8000)  # Specify SSE endpoint

remote integration streamable http

yaml
paths:
  /mcp:
    post:
      x-ms-agentic-protocol: mcp-streamable-1.0  # Copilot Studio integration

platform integration github

{"command": "docker", "args": ["run", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"]}

development framework fastmcp

python
from mcp.server import FastMCP
app = FastMCP('demo')
@app.tool()
async def query(): ...

Tools

  1. get-todo-tasks

    Get all tasks from TODO.md

  2. get-todo-tasks-by-version

    Get tasks for a specific version

  3. add-todo-task

    Add a new task for a specific version

  4. update-todo-task

    Update an existing task

  5. add-todo-version

    Add a new version section

  6. import-todo

    Import and format an existing TODO.md

  7. get-changelog

    Get all changelog entries

  8. get-changelog-by-version

    Get changelog entries for a specific version

  9. add-changelog-entry

    Add a new changelog version entry

  10. update-changelog-entry

    Update an existing changelog entry

  11. import-changelog

    Import and format an existing CHANGELOG.md

  12. generate-changelog-from-todo

    Generate a new CHANGELOG.md entry based on completed tasks in TODO.md