What is Task Tracker Mcp

task-tracker-mcp is a task management system designed for LLM-based agents, allowing them to manage tasks efficiently within a unified framework. All tasks are organized in a single tree structure, accessible immediately upon server startup.

Use cases

Use cases for task-tracker-mcp include managing tasks for AI agents in research projects, automating workflows in software development, and organizing tasks in data processing pipelines.

How to use

To use task-tracker-mcp, clone the repository from GitHub, set up the environment by configuring the Claude Desktop configuration file, and start the MCP server using the provided commands. You can also run tests and utilize the FastAPI service with MCP tools.

Key features

Key features of task-tracker-mcp include a unified task management system, immediate task availability upon server start, compatibility with Python 3.13 or higher, and the ability to inspect the server using the Model Context Protocol inspector.

Where to use

task-tracker-mcp can be utilized in various fields where task management is essential, particularly in AI and machine learning environments where LLM agents are deployed to automate and manage tasks.

task-tracker-mcp

Description

task-tracker-mcp is a task management system for LLM-based agents. All tasks are stored in a single tree, available immediately after the server starts.

Main Goal

Enable LLM agents to manage their tasks through a unified Task manager.

Requirements

• Python 3.13 or higher
• Node.js and npm (for @modelcontextprotocol/inspector)

Installation

Cloning the Repository

git clone [email protected]:feodal01/task-tracker-mcp.git
cd task-tracker-mcp

Setting Up the Environment

Configuration

Open the Claude Desktop configuration file located at:

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Add the following:

{
  "mcpServers": {
    "mcpServer": {
      "command": "uv",
      "args": [
        "--directory",
        "/Path/to/task-tracker-mcp",
        "run",
        "python",
        "-m",
        "mcp_server.mcp_service"
      ],
      "env": {
        "PYTHONPATH": "/Path/to/task-tracker-mcp/src"
      }
    }
  }
}

Running the Project

Starting the MCP Server

Using uv:

export PYTHONPATH=/Path/to/task-tracker-mcp/src
uv run python -m src.mcp_server.mcp_service

Starting the Inspector

To inspect the MCP server, use:
uv:

npx @modelcontextprotocol/inspector uv --directory /Path/to/task-tracker-mcp run python -m mcp_server.mcp_service 

Running Tests

uv:

export PYTHONPATH=/Path/to/task-tracker-mcp/src
uv run pytest tests/

Running FastApi service with MCP tools

export PYTHONPATH=/Path/to/task-tracker-mcp/src
uv --directory /Path/to/task-tracker-mcp run python -m mcp_server.mcp_rest_service

License

This project is licensed under the MIT License — see the LICENSE file for details.

Contribution

Want to contribute? Fork the repository and submit a pull request.

Contacts

If you have any questions, contact me at: [email protected]