使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 构建的 Google Tasks 服务器。它允许大型语言模型（LLM）通过标准的 MCP 协议与 Google Tasks API 集成，从而实现对 Google Tasks 任务的管理。该服务器提供资源访问和工具调用，使得 LLM 能够方便地创建、读取、更新和删除 Google Tasks 任务。

主要功能点

资源管理:
- 提供默认任务列表资源 ('tasks://default')，允许 LLM 客户端读取 Google Tasks 中的任务列表。
工具集成:
- 'create_task': 创建新的 Google Task 任务。
- 'list_tasks': 列出默认任务列表中的所有任务。
- 'delete_task': 删除指定的 Google Task 任务。
- 'update_task': 更新已存在的 Google Task 任务的信息。
- 'complete_task': 切换指定 Google Task 任务的完成状态。

安装步骤

安装 Node.js 和 npm: 确保你的系统中已安装 Node.js 和 npm (Node 包管理器)。

克隆仓库: 将 GitHub 仓库 'mstfe_mcp-google-tasks' 克隆到本地。

git clone https://github.com/MCP-Mirror/mstfe_mcp-google-tasks
cd mstfe_mcp-google-tasks

安装依赖: 在仓库目录下，使用 npm 安装项目依赖。
```
npm install
```
配置 Google API 凭据:
- 你需要配置 Google API 访问凭据才能连接到你的 Google Tasks。参考仓库 'README.md' 文件或者 Google Tasks API 的文档，配置 OAuth 2.0 客户端 ID、客户端密钥、重定向 URI、访问令牌和刷新令牌等环境变量 (例如 'CLIENT_ID', 'CLIENT_SECRET', 'REDIRECT_URI', 'ACCESS_TOKEN', 'REFRESH_TOKEN')。
构建项目: 使用 npm 构建 TypeScript 项目。
```
npm run build
```

服务器配置

MCP 客户端需要以下配置信息来启动和连接到 Google Tasks MCP 服务器。将以下 JSON 配置添加到你的 MCP 客户端配置中：

{
  "serverName": "google-tasks-server",
  "command": "node",
  "args": ["build/index.js"]
}

'serverName': 服务器名称，可以自定义，用于在 MCP 客户端中标识该服务器。
'command': 启动服务器的命令，这里使用 'node' 解释器来运行 JavaScript 文件。
'args': 传递给 'node' 命令的参数，即编译后的服务器入口文件路径 'build/index.js'。

基本使用方法

启动服务器: 在仓库根目录下，运行以下命令启动 Google Tasks MCP 服务器。
```
node build/index.js
```
服务器将在标准输入/输出 (stdio) 上运行，并等待 MCP 客户端的连接和请求。
配置 MCP 客户端: 在你的 MCP 客户端应用中，配置连接到该服务器。客户端需要能够通过 stdio 与服务器进行 JSON-RPC 通信。
使用 MCP 客户端发送请求: 使用 MCP 客户端向服务器发送请求，例如列出资源、调用工具等。具体的请求格式和参数可以参考 MCP 协议文档和该仓库 'README.md' 中工具的描述。例如，调用 'create_task' 工具创建一个新任务。

注意事项

环境变量: 确保已正确配置 Google API 相关的环境变量，否则服务器可能无法连接到 Google Tasks API。
调试: 如果遇到问题，可以使用仓库 'README.md' 中推荐的 MCP Inspector 工具进行调试。

关键词