项目简介

Taskade MCP 服务器是 Taskade 官方推出的、基于 Model Context Protocol (MCP) 构建的后端应用。它允许兼容 MCP 协议的大型语言模型 (LLM) 客户端(如 Claude、Cursor 等)直接与 Taskade 服务进行交互,执行任务管理、项目操作等。

主要功能点

该服务器将 Taskade 的 API 功能封装为 LLM 可以调用的工具。主要功能包括:

  • 工作区和文件夹管理: 获取用户的所有工作区和工作区下的文件夹信息。
  • 项目管理: 创建、获取、复制项目,获取文件夹下的项目列表。
  • 任务管理: 获取项目的任务和块信息,创建、更新、完成、移动任务。
  • 任务详情管理: 获取、更新、删除任务的指派人、日期和笔记。
  • API 工具化: 将 Taskade API 的特定端点转化为 LLM 可理解和执行的工具函数。

安装步骤

  1. 克隆仓库: 从 GitHub 克隆 'taskade/mcp' 仓库到本地。
  2. 安装依赖: 进入仓库目录,使用 Node.js 包管理器安装项目依赖。
    npm install
    # 或者
    yarn install
  3. 构建 CLI: 构建命令行界面入口文件。
    npm run build:cli
    # 或者
    yarn build:cli

服务器配置

MCP 客户端需要知道如何启动和连接到此服务器。对于通过标准输入输出 (Stdio) 连接的客户端,通常需要在客户端的 MCP 服务器配置中指定执行服务器二进制文件的命令和参数。

该 Taskade MCP 服务器的 CLI 入口点位于 'bin/cli.mjs',并且需要通过环境变量 'TASKADE_API_KEY' 提供 Taskade 的 API 访问令牌。

例如,一个典型的 MCP 客户端配置(JSON 格式描述)可能如下:

{
  "name": "taskade-mcp-server",
  "command": "node",
  "args": [
    "/path/to/your/cloned/mcp/repository/bin/cli.mjs"
  ],
  "env": {
    "TASKADE_API_KEY": "YOUR_TASKADE_API_KEY"
  }
}
  • 'name': 服务器的唯一标识名称(可自定义)。
  • 'command': 执行服务器的可执行文件或命令,在此为 'node'。
  • 'args': 传递给命令的参数,指向构建好的服务器 CLI 脚本路径。请将 '/path/to/your/cloned/mcp/repository/' 替换为你实际克隆仓库的路径。
  • 'env': 启动服务器时设置的环境变量。'TASKADE_API_KEY' 是必填项,请替换 '"YOUR_TASKADE_API_KEY"' 为你的 Taskade API 令牌。

注意: 获取 Taskade API 令牌需要访问 Taskade 开发者设置。

基本使用方法

  1. 获取 API 密钥: 访问 Taskade 开发者设置,生成或找到你的 API 密钥。
  2. 配置 MCP 客户端: 在你使用的 MCP 兼容 LLM 客户端中,按照其文档说明添加一个新的 MCP 服务器配置。使用上述提供的配置信息,填入正确的 'command' 路径和你的 'TASKADE_API_KEY'。
  3. 连接服务器: 在客户端中启用或连接到配置好的 Taskade MCP 服务器。
  4. 通过 LLM 调用功能: 一旦连接成功,LLM 客户端将能够发现并调用服务器暴露的 Taskade 工具。你可以通过与 LLM 对话,指示它执行 Taskade 中的任务,例如创建项目、查询任务列表、完成任务等,LLM 将通过 MCP 协议调用相应的服务器工具来完成操作。

信息

分类

AI与计算