使用说明

项目简介

Google Tasks Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它充当 LLM 客户端和 Google Tasks API 之间的桥梁。通过这个服务器，LLM 客户端可以方便地读取、搜索、创建、更新和删除 Google Tasks 中的任务，从而扩展 LLM 的能力，使其能够进行任务管理和日程安排。

主要功能点

任务管理工具: 提供了丰富的工具，包括：
- 搜索任务 (search): 根据关键词搜索 Google Tasks 中的任务。
- 列出任务 (list): 列出 Google Tasks 中的所有任务，支持分页。
- 创建任务 (create): 在 Google Tasks 中创建新任务，可以指定标题、备注和截止日期。
- 更新任务 (update): 更新 Google Tasks 中已存在的任务，可以修改标题、备注、状态和截止日期。
- 删除任务 (delete): 删除 Google Tasks 中指定的任务。
- 清除已完成任务 (clear): 清除 Google Tasks 任务列表中已完成的任务。
任务资源访问: 允许 LLM 客户端通过标准化的资源 URI (例如 'gtasks:///task_id') 访问 Google Tasks 任务的详细信息，包括标题、状态、截止日期、备注等。

安装步骤

创建 Google Cloud 项目并启用 Google Tasks API:
- 访问 Google Cloud Console 创建一个新的 Google Cloud 项目。
- 在项目中启用 Google Tasks API。
配置 OAuth 同意屏幕:
- 访问 OAuth 同意屏幕配置，配置 OAuth 同意屏幕。
- 对于测试目的，选择 "内部" 用户类型即可。
- 添加 'https://www.googleapis.com/auth/tasks' 作用域。
创建 OAuth 客户端 ID:
- 访问 OAuth 客户端 ID 创建，创建 "桌面应用" 类型的 OAuth 客户端 ID。
- 下载生成的 JSON 密钥文件。
放置密钥文件:
- 将下载的 JSON 密钥文件重命名为 'gcp-oauth.keys.json'，并放置到仓库根目录下（与 'package.json' 文件同级）。

安装依赖并构建项目:

npm install
npm run build

服务器配置

要将此 MCP 服务器集成到 MCP 客户端（例如支持 MCP 协议的桌面应用），需要在客户端的服务器配置中添加以下 JSON 配置。请将 '{ABSOLUTE PATH TO FILE HERE}' 替换为 'dist/index.js' 文件的绝对路径。

{
  "mcpServers": {
    "gtasks": { # 服务器名称，客户端使用此名称引用该服务器
      "command": "/opt/homebrew/bin/node", # 启动服务器的命令，通常为 Node.js 的执行路径
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js" # 服务器启动参数，指向编译后的 index.js 文件
      ]
    }
  }
}

基本使用方法

首次运行进行身份验证:
```
npm run start auth
```
这会启动身份验证流程，并在浏览器中打开 Google 授权页面。完成授权后，凭据将保存在仓库根目录下的 '.gdrive-server-credentials.json' 文件中。
运行 MCP 服务器:
```
npm run start
```
服务器将在后台运行，等待 MCP 客户端的连接和请求。
在 MCP 客户端中使用:
- 确保 MCP 客户端已配置正确的服务器配置信息（如上所示）。
- 在 LLM 交互中，可以使用工具名称（如 'search', 'list', 'create' 等）来调用 Google Tasks 的功能。
- 可以使用资源 URI (例如 'gtasks:///your_task_id') 来引用和访问 Google Tasks 任务资源。

注意: 首次运行 'npm run start auth' 进行身份验证是必要的步骤。之后，可以直接运行 'npm run start' 启动服务器。

关键词