任务管理MCP服务器

一个基于TypeScript的MCP服务器,用于通过Google Tasks API高效管理任务,支持创建、列出、删除、更新和切换任务完成状态。

  • by mstfe
  • JavaScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 mstfe/mcp-google-tasks

使用说明

谷歌任务MCP服务器

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

这个基于类型脚本的MCP服务器通过与Google Tasks API集成来展示核心MCP概念。它允许以结构化和高效的方式管理任务。


特性

资源

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

工具

  • create_task:在默认任务列表中创建新任务。
    • 参数:
      • title (字符串,可选):任务的标题。
      • notes (string,可选):任务的其他注释。
      • 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": "Complete project",
      "notes": "Finalize module 3",
      "status": "needsAction"
    }
    
  • list_tasks: 检索默认任务列表中的所有任务。
    • 无需参数。
    • 返回一个任务数组。
  • delete_task: 按任务ID删除任务。
    {
      "taskId": "unique-task-id"
    }
    
  • update_task: 通过任务ID更新任务的标题、注释或其他详细信息。
    {
      "taskId": "unique-task-id",
      "title": "Updated task title",
      "notes": "Updated task notes"
    }
    
  • complete_task: 切换任务的完成状态。
    {
      "taskId": "unique-task-id"
    }
    

示例响应 complete_task

竣工前

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

竣工后

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

调试

由于MCP服务器通过stdio进行通信,调试需要额外的工具。我们建议使用 MCP检查员.

启动检查器:

npm run inspector

检查器将提供一个URL来访问浏览器中的调试工具,从而更容易测试和调试服务器。

许可证

此MCP服务器根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。