Servidor MCP de Tracker

Este es un servidor MCP (Model Context Protocol) diseñado para conectarse a tu tracker-server local. Expone puntos de conexión como consultar el horario de hoy, obtener estadísticas, registrar tareas y gestionar temporizadores directamente a clientes LLM (como Claude Desktop o Cursor).

Requisitos previos

• Una instancia de tracker-server en ejecución (normalmente en http://localhost:3000).

• Python 3.11+ (si se ejecuta localmente) o Docker.

Related MCP server: mcp-server-tasktracker

🚀 Ejecución mediante Docker (Recomendado)

Cuando despliegues tu agente MCP, puedes conectarlo directamente a la imagen de Docker proporcionada desde el Registro de Contenedores de GitHub.

Debido a que tracker-server se está ejecutando en tu máquina local, Docker necesita saber cómo acceder a él. La imagen utiliza por defecto http://host.docker.internal:3000 asumiendo que estás en Mac/Windows o utilizando Docker Desktop.

Para la configuración de 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"
      ]
    }
  }
}

Nota: Observa la bandera -i. Debido a que MCP se comunica a través de stdin/stdout (stdio), debes ejecutar el contenedor de Docker de forma interactiva, pero sin un TTY (-t).

🛠 Ejecución local

Si estás desarrollando o simplemente prefieres ejecutar desde el código fuente en lugar de Docker.

1. Configura el entorno virtual:

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

2. Ejecuta el servidor MCP manualmente:

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

Nota: Esto simplemente bloqueará tu terminal esperando comandos JSON RPC de MCP a través de stdio. Esto es lo esperado.

3. Configura Claude Desktop (Modo local):

{
  "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"
      }
    }
  }
}