任务管理服务器

一个实现MCP协议的服务器,提供与Google Tasks API交互的工具,便于与兼容MCP的助手、代理或自动化流程集成。

  • by GamaRiverib
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 gamariverib/google-tasks-mcp-server

使用说明

谷歌任务MCP服务器

该项目实现了一个MCP(Model Context Protocol)服务器,该服务器公开了与谷歌任务API交互的工具。它允许使用MCP工具列出、创建、更新、删除和搜索谷歌任务列表和任务,使其更容易与MCP兼容的自动向导、代理或流集成。

主要特征

  • Autenticación OAuth2与谷歌任务。
  • 列出、创建、更新和删除任务列表。
  • 列出、搜索、创建、更新、完成、重新打开和删除任务。
  • 通过STDIO传输,以简单地集成到管道或MCP代理中。
  • 使用环境变量设置结果限制 MAX_TASK_RESULTS.

要求

  • Node.js
  • 启用谷歌任务API的谷歌云平台帐户。
  • OAuth2凭据下载为 credentials.json.

安装和使用

  1. 安装依赖项:

    npm install
    
  2. 将您的OAuth2凭据放入 credentials.json 在项目的根。

  3. 编译TypeScript代码:

    npx tsc
    
  4. 运行MCP服务器:

    node build/index.js
    

    第一次,将在浏览器中打开一个身份验证流,以授权访问您的谷歌任务帐户。

  5. 整合:

    • MCP服务器通过STDIO进行通信,并公开诸如 list-task-lists, create-task, update-task, delete-task,除其他外,供MCP客户使用。

克劳德桌面上的配置示例

要将此MCP服务器集成到Claude Desktop中,请在文件中添加一个条目 claude_desktop_config.json (或在相应的配置部分)例如以下示例。确保调整 {RUTA} 到您的项目的实际位置:

{
  "mcp_servers": [
    {
      "id": "google-tasks",
      "name": "Google Tasks MCP Server",
      "description": "Servidor MCP para gestionar Google Tasks mediante herramientas MCP.",
      "command": "node",
      "args": [
        "{RUTA}/google-tasks/build/index.js"
      ],
      "env": {
        "MAX_TASK_RESULTS": "100"
      }
    }
  ]
}
  • 取代 {RUTA} 通过您的项目所在的绝对路径,例如: D:/Projects/mcp-servers.
  • 如何使用 npx,你可以改变 "command" y "args" 因此:
    "command": "npx",
    "args": [
      "@gamariverib/google-tasks"
    ]
    

这将使Claude Desktop能够正确检测和使用Google Tasks的MCP服务器。

注释

  • 档案馆 token.json 它在身份验证后自动生成,并存储访问和刷新令牌。
  • 查询源代码 src/index.ts 查看每个工具的定义及其详细使用。