项目简介
Taskade MCP 服务器是 Taskade 官方推出的、基于 Model Context Protocol (MCP) 构建的后端应用。它允许兼容 MCP 协议的大型语言模型 (LLM) 客户端(如 Claude、Cursor 等)直接与 Taskade 服务进行交互,执行任务管理、项目操作等。
主要功能点
该服务器将 Taskade 的 API 功能封装为 LLM 可以调用的工具。主要功能包括:
- 工作区和文件夹管理: 获取用户的所有工作区和工作区下的文件夹信息。
- 项目管理: 创建、获取、复制项目,获取文件夹下的项目列表。
- 任务管理: 获取项目的任务和块信息,创建、更新、完成、移动任务。
- 任务详情管理: 获取、更新、删除任务的指派人、日期和笔记。
- API 工具化: 将 Taskade API 的特定端点转化为 LLM 可理解和执行的工具函数。
安装步骤
- 克隆仓库: 从 GitHub 克隆 'taskade/mcp' 仓库到本地。
- 安装依赖: 进入仓库目录,使用 Node.js 包管理器安装项目依赖。
npm install # 或者 yarn install - 构建 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 开发者设置。
基本使用方法
- 获取 API 密钥: 访问 Taskade 开发者设置,生成或找到你的 API 密钥。
- 配置 MCP 客户端: 在你使用的 MCP 兼容 LLM 客户端中,按照其文档说明添加一个新的 MCP 服务器配置。使用上述提供的配置信息,填入正确的 'command' 路径和你的 'TASKADE_API_KEY'。
- 连接服务器: 在客户端中启用或连接到配置好的 Taskade MCP 服务器。
- 通过 LLM 调用功能: 一旦连接成功,LLM 客户端将能够发现并调用服务器暴露的 Taskade 工具。你可以通过与 LLM 对话,指示它执行 Taskade 中的任务,例如创建项目、查询任务列表、完成任务等,LLM 将通过 MCP 协议调用相应的服务器工具来完成操作。
信息
分类
AI与计算