Servidor MCP de Tareas

Servidor MCP (Model Context Protocol) desarrollado con FastMCP y Python para la gestión de tareas, con base de datos MySQL en Docker.

🚀 Inicio rápido con Docker

Requisitos

Docker y Docker Compose instalados y en ejecución.

Levantar los contenedores

Para construir y levantar el servidor MCP y la base de datos MySQL:

docker compose up -d --build

Esto iniciará:

tareas_mysql: Base de datos MySQL 8.0 en el puerto 3306.
tareas_mcp_server: Servidor MCP en el puerto 8000 (Streamable HTTP / SSE).

Ver los logs

docker compose logs -f

Detener los contenedores

docker compose down

🛠️ Herramientas MCP disponibles

get_tareas: Obtiene la lista completa de tareas.
get_tarea_by_id: Consulta una tarea específica por su ID.
crear_tarea: Registra una nueva tarea (titulo, fecha, completado).
actualizar_tarea: Modifica los campos de una tarea existente.
eliminar_tarea: Elimina una tarea por su ID.
marcar_completada: Marca una tarea como realizada (completado = 1).
marcar_pendiente: Marca una tarea como pendiente (completado = 0).
get_tareas_pendientes: Lista únicamente las tareas sin completar.
get_tareas_completadas: Lista únicamente las tareas completadas.

🔌 Conexión desde Clientes MCP

Opción 1: Conexión vía SSE / HTTP (Docker corriendo)

Si tu cliente MCP soporta transporte SSE / HTTP:

URL: http://localhost:8000/sse

Opción 2: Conexión directa vía stdio (Claude Desktop / Local)

En claude_desktop_config.json:

{
  "mcpServers": {
    "tareas-mcp": {
      "command": "python",
      "args": [
        "c:\\Users\\USER\\Desktop\\ADSO 19\\mcp\\server_mcp.py"
      ]
    }
  }
}

(Asegúrate de que la base de datos esté corriendo, ya sea en Docker o localmente).