Google Tasks MCP 服务器

一个用于管理 Google Tasks 的模型上下文协议 (MCP) 服务器。

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

---

功能特性

资源

• 默认任务列表: 通过 URI tasks://default 访问默认 Google Tasks 列表中的任务。
• 任务详情: 提供关于任务的元数据，例如标题、备注和完成状态。
• 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 提供与大型语言模型 (LLM) 或其他应用程序的轻松集成。
• 结构化的工具定义使任务管理直观且易于访问。
• 完全支持创建、列出、删除、更新和切换任务的完成状态。

---

用法

运行服务器

要启动服务器:

node build/index.js

可用命令

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

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

• list_tasks: 检索默认任务列表中的所有任务。
  • 无需参数。
  • 返回一个任务数组。
• delete_task: 通过 ID 删除一个任务。

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

• update_task: 通过 ID 更新任务的标题、备注或其他详细信息。

  {
    "taskId": "unique-task-id",
    "title": "更新后的任务标题",
    "notes": "更新后的任务备注"
  }
  

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

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

complete_task 的示例响应

完成前

{
  "taskId": "unique-task-id",
  "title": "完成报告",
  "status": "needsAction"
}

完成后

{
  "taskId": "unique-task-id",
  "title": "完成报告",
  "status": "completed"
}

---

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试需要额外的工具。 我们建议使用 MCP Inspector。

要启动 Inspector:

npm run inspector

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

许可证

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