Servidor MCP de Google Tasks

Un servidor de Protocolo de Contexto de Modelo (MCP) para administrar Tareas de Google.

Este servidor MCP basado en TypeScript demuestra los conceptos básicos de MCP al integrarse con la API de Google Tasks. Permite gestionar tareas de forma estructurada y eficiente.

Características

Recursos

• Lista de tareas predeterminada : acceda a las tareas en la lista de tareas predeterminada de Google a través del URI tasks://default .

• Detalles de la tarea : proporciona metadatos sobre las tareas, como título, notas y estado de finalización.

• Tipo MIME JSON : Las tareas se representan en un formato JSON legible por máquina.

Herramientas

• create_task : crea una nueva tarea en la lista de tareas predeterminada.

  • Parámetros :

    • title (cadena, opcional): Título de la tarea.

    • notes (cadena, opcional): notas adicionales para la tarea.

    • taskId (cadena, opcional): ID único para la tarea.

    • status (cadena, opcional): estado de la tarea (por ejemplo, "necesita acción" o "completada").

  • Respuesta : Devuelve los detalles de la tarea creada.

• list_tasks : enumera todas las tareas en la lista de tareas predeterminada.

  • Parámetros : Ninguno.

  • Respuesta : Devuelve una matriz JSON de todas las tareas en la lista de tareas predeterminada.

• delete_task : elimina una tarea de la lista de tareas predeterminada.

  • Parámetros :

    • taskId (cadena, obligatoria): ID de la tarea a eliminar.

  • Respuesta : Confirma la eliminación exitosa de la tarea.

• update_task : actualiza una tarea existente en la lista de tareas predeterminada.

  • Parámetros :

    • taskId (cadena, obligatoria): ID de la tarea a actualizar.

    • title (cadena, opcional): nuevo título para la tarea.

    • notes (cadena, opcional): Nuevas notas para la tarea.

  • Respuesta : Devuelve los detalles actualizados de la tarea.

• complete_task : alterna el estado de finalización de una tarea.

  • Parámetros :

    • taskId (cadena, obligatoria): ID de la tarea cuyo estado de finalización se alternará.

  • Respuesta : Devuelve los detalles de la tarea actualizados, incluido el nuevo estado.

Related MCP server: MCP Server

Funcionalidad

• Proporciona una fácil integración con modelos de lenguaje grandes (LLM) u otras aplicaciones a través de MCP.

• Las definiciones de herramientas estructuradas hacen que la gestión de tareas sea intuitiva y accesible.

• Soporte completo para crear, enumerar, eliminar, actualizar y alternar el estado de finalización de las tareas.

Uso

Ejecución del servidor

Para iniciar el servidor:

node build/index.js

Comandos disponibles

• create_task : crea una nueva tarea con parámetros opcionales.

  {
    "title": "Complete project",
    "notes": "Finalize module 3",
    "status": "needsAction"
  }

• list_tasks : recupera todas las tareas en la lista de tareas predeterminada.

  • No se requieren parámetros.

  • Devuelve una matriz de tareas.

• delete_task : elimina una tarea por su ID.

  {
    "taskId": "unique-task-id"
  }

• update_task : actualiza el título, las notas u otros detalles de una tarea por su ID.

  {
    "taskId": "unique-task-id",
    "title": "Updated task title",
    "notes": "Updated task notes"
  }

• complete_task : alterna el estado de finalización de una tarea.

  {
    "taskId": "unique-task-id"
  }

Ejemplo de respuesta para complete_task

Antes de la finalización

{
  "taskId": "unique-task-id",
  "title": "Finish the report",
  "status": "needsAction"
}

Después de la finalización

{
  "taskId": "unique-task-id",
  "title": "Finish the report",
  "status": "completed"
}

Depuración

Dado que los servidores MCP se comunican mediante stdio, la depuración requiere herramientas adicionales. Recomendamos usar el Inspector MCP .

Para iniciar el inspector:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador, lo que facilitará la prueba y depuración del servidor.

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que usted tiene libertad de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT.