Google Tasks MCP Server

这是一个用于管理Google任务的Model Context Protocol (MCP)服务器。

此基于TypeScript的MCP服务器通过与Google任务API集成，展示了核心MCP概念。它允许以结构化和高效的方式管理任务。

---

功能

资源

• 默认任务列表：通过URI tasks://default 访问默认Google任务列表中的任务。
• 任务详情：提供有关任务的元数据，如标题、备注和完成状态。
• JSON MIME类型：任务以机器可读的JSON格式表示。

工具

• create_task：在默认任务列表中创建一个新任务。
  • 参数：
    • title（字符串，可选）：任务的标题。
    • notes（字符串，可选）：任务的附加备注。
    • taskId（字符串，可选）：任务的唯一ID。
    • status（字符串，可选）：任务的状态（例如，“needsAction”或“completed”）。
  • 响应：返回创建的任务的详细信息。
• list_tasks：列出默认任务列表中的所有任务。
  • 参数：无。
  • 响应：返回默认任务列表中所有任务的JSON数组。
• delete_task：从默认任务列表中删除一个任务。
  • 参数：
    • taskId（字符串，必需）：要删除的任务的ID。
  • 响应：确认成功删除任务。
• update_task：更新默认任务列表中的现有任务。
  • 参数：
    • taskId（字符串，必需）：要更新的任务的ID。
    • title（字符串，可选）：任务的新标题。
    • notes（字符串，可选）：任务的新备注。
  • 响应：返回更新后的任务详细信息。
• complete_task：切换任务的完成状态。
  • 参数：
    • taskId（字符串，必需）：要切换完成状态的任务的ID。
  • 响应：返回更新后的任务详细信息，包括新的状态。

---

功能性

• 提供了通过MCP轻松集成大型语言模型（LLMs）或其他应用程序的方法。
• 结构化的工具定义使得任务管理直观且易于访问。
• 完全支持创建、列出、删除、更新以及切换任务的完成状态。

---

使用方法

运行服务器

启动服务器：

node build/index.js

可用命令

• create_task： 使用可选参数创建一个新任务。

  {
    "title": "完成项目",
    "notes": "最终模块3",
    "status": "needsAction"
  }
  

• list_tasks： 获取默认任务列表中的所有任务。
  • 不需要任何参数。
  • 返回任务数组。
• delete_task： 根据其ID删除一个任务。

  {
    "taskId": "唯一任务ID"
  }
  

• update_task： 根据其ID更新任务的标题、备注或其他详细信息。

  {
    "taskId": "唯一任务ID",
    "title": "更新的任务标题",
    "notes": "更新的任务备注"
  }
  

• complete_task： 切换任务的完成状态。

  {
    "taskId": "唯一任务ID"
  }
  

complete_task示例响应

完成前

{
  "taskId": "唯一任务ID",
  "title": "完成报告",
  "status": "needsAction"
}

完成后

{
  "taskId": "唯一任务ID",
  "title": "完成报告",
  "status": "completed"
}

---

调试

由于MCP服务器通过标准I/O进行通信，调试需要额外的工具。我们推荐使用MCP Inspector。

启动Inspector：

npm run inspector

Inspector将提供一个URL，您可以在浏览器中访问调试工具，从而更容易地测试和调试服务器。

许可证

此MCP服务器根据MIT许可证发布。这意味着您可以自由使用、修改和分发该软件，但需遵守MIT许可证的条款和条件。