使用说明

项目简介

Google Tasks MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端,它充当 Claude 等大型语言模型 (LLM) 与 Google Tasks 之间的桥梁。通过这个服务器,用户可以使用自然语言指令,让 Claude 管理 Google Tasks 中的任务列表和任务。

主要功能点

  • 任务列表管理
    • 列出所有任务列表
    • 获取指定任务列表的详细信息
    • 创建新的任务列表
    • 更新已有的任务列表
    • 删除任务列表
  • 任务管理
    • 列出任务列表中的所有任务
    • 获取指定任务的详细信息
    • 创建新的任务
    • 更新已有的任务
    • 删除任务
    • 完成任务
    • 移动任务(重新排序或更改父任务)
    • 清除已完成的任务

安装步骤

  1. 安装 Node.js: 确保你的电脑上已安装 Node.js (版本 14 或更高)。
  2. 克隆仓库: 将 GitHub 仓库 'https://github.com/arpitbatra123/mcp-googletasks' 克隆到本地。
  3. 安装依赖: 在仓库根目录下,打开终端并运行 'npm install' 安装项目依赖。
  4. 构建项目: 运行 'npm run build' 构建项目,生成可执行的 JavaScript 文件。

服务器配置

要将此 MCP 服务器连接到 Claude Desktop 客户端,你需要编辑 Claude 的配置文件 'claude_desktop_config.json'。

  1. 找到配置文件:

    • MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
    • Windows: '%APPDATA%\Claude\claude_desktop_config.json'
  2. 添加服务器配置: 在 'mcpServers' 字段中添加以下 JSON 配置,替换占位符为你自己的 Google Cloud 项目凭据和服务器路径。

{
  "mcpServers": {
    "google-tasks": {
      "command": "node",
      "args": ["/path/to/mcp-googletasks/build/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "YOUR_GOOGLE_CLIENT_ID",  // 替换为你的 Google OAuth 客户端 ID
        "GOOGLE_CLIENT_SECRET": "YOUR_GOOGLE_CLIENT_SECRET", // 替换为你的 Google OAuth 客户端密钥
        "GOOGLE_REDIRECT_URI": "http://localhost:3000/oauth2callback"
      }
    }
  }
}
  • 'command': 启动服务器的命令,这里使用 'node' 运行 JavaScript 文件。
  • 'args': 命令参数,指向构建后的服务器入口文件 'build/index.js' 的绝对路径。请根据你的实际项目路径修改 '/path/to/mcp-googletasks'。
  • 'env': 环境变量配置,用于 Google OAuth 认证。
    • 'GOOGLE_CLIENT_ID': 你的 Google Cloud 项目 OAuth 客户端 ID。
    • 'GOOGLE_CLIENT_SECRET': 你的 Google Cloud 项目 OAuth 客户端密钥。
    • 'GOOGLE_REDIRECT_URI': OAuth 重定向 URI,保持 'http://localhost:3000/oauth2callback' 不变。

注意: 你需要在 Google Cloud Console 中创建一个项目,启用 Google Tasks API,并配置 OAuth 客户端 ID 和密钥。具体步骤请参考仓库 README.md 中的 "Setup Instructions"。

  1. 重启 Claude Desktop: 配置完成后,重启 Claude Desktop 客户端使配置生效。

基本使用方法

  1. 启动服务器: 在仓库根目录下,运行 'npm run start' 启动 MCP 服务器。
  2. Claude 中进行身份验证: 在 Claude 中,首先使用 'authenticate' 工具。Claude 会返回一个 URL,复制 URL 在浏览器中打开并登录你的 Google 账号完成授权。
  3. 设置授权码: 授权成功后,浏览器页面会显示一个授权码。复制这个授权码,然后在 Claude 中使用 'set-auth-code' 工具,并将授权码作为参数输入。
  4. 使用 Google Tasks 工具: 身份验证成功后,你就可以在 Claude 中使用其他 Google Tasks 工具来管理你的任务列表和任务了,例如 'list-tasklists'、'create-task' 等。

注意: 每次服务器重启后,都需要重新进行身份验证。

信息

分类

生产力应用