MCP-сервер Tracker

Это сервер MCP (Model Context Protocol), предназначенный для подключения к вашему локальному tracker-server. Он предоставляет LLM-клиентам (таким как Claude Desktop или Cursor) такие возможности, как проверка расписания на сегодня, получение статистики, регистрация задач и управление таймерами.

Предварительные требования

• Запущенный экземпляр tracker-server (обычно на http://localhost:3000).

• Python 3.11+ (при локальном запуске) или Docker.

Related MCP server: mcp-server-tasktracker

🚀 Запуск через Docker (рекомендуется)

При развертывании вашего MCP-агента вы можете подключить его напрямую к Docker-образу, предоставленному в GitHub Container Registry.

Поскольку tracker-server запущен на вашем локальном хосте, Docker должен знать, как к нему обратиться. Образ по умолчанию использует http://host.docker.internal:3000, предполагая, что вы используете Mac/Windows или Docker Desktop.

Для конфигурации Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "tracker-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TRACKER_API_URL=http://host.docker.internal:3000",
        "ghcr.io/makegorka/tracker-mcp:latest"
      ]
    }
  }
}

Примечание: Обратите внимание на флаг -i. Поскольку MCP взаимодействует через stdin/stdout (stdio), вы должны запускать Docker-контейнер в интерактивном режиме, но без TTY (-t).

🛠 Локальный запуск

Если вы занимаетесь разработкой или просто предпочитаете запускать программу из исходного кода, а не через Docker.

1. Настройка виртуального окружения:

   cd tracker-mcp
   python -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt

2. Запуск MCP-сервера вручную:

   # Make sure your tracker server is running!
   python server.py

   Примечание: Это заблокирует ваш терминал в ожидании команд MCP JSON RPC через stdio. Это ожидаемое поведение.

3. Настройка Claude Desktop (локальный режим):

   {
     "mcpServers": {
       "tracker-mcp": {
         "command": "/absolute/path/to/tracker-mcp/venv/bin/python",
         "args": [
           "/absolute/path/to/tracker-mcp/server.py"
         ],
         "env": {
           "TRACKER_API_URL": "http://localhost:3000"
         }
       }
     }
   }