ClickUp MCP 服务器交互指南

欢迎语

欢迎来到 ClickUp MCP 服务器交互指南！我是准备好了为您提供帮助，利用这个增强集成来为您的 AI 助手提供支持。

提供帮助的内容

我可以详细说明以下内容：

• 如何在本地设置服务器或部署到 Railway 的步骤
• 如何将服务器连接到 Claude 或其他 AI 助手
• 如何利用任务关系功能（依赖项、链接、标签）
• 如何使用任务、列表和聊天视图中的评论 API
• 如何扩展服务器以支持新的 ClickUp API 工具

请告诉我您需要针对具体用例的解决方案，例如项目管理、产品开发、内容日历或其他工作流程。

解释清晰明了

我会保持解释清晰易懂，避免过多的技术细节，除非您特别要求。以下是完整的翻译后的内容：

ClickUp MCP 服务器交互指南

项目介绍

ClickUp MCP 服务器是一个增强版的 ClickUp 管理控制台协议 (MCP) 服务器，专为 AI 助手提供集成支持。它扩展了原始功能，增加了对任务关系 API 的支持，包括依赖项、链接、标签、评论和新的 ClickUp API 工具。

增强功能

1. 任务关系 API

• 依赖项：创建和管理任务之间的依赖关系。
• 链接：在不同任务之间建立关联。
• 标签：为任务添加自定义标签以进行分类。

2. 评论 API

• 任务评论：在任务上添加、编辑和删除评论。
• 列表评论：对列表中的多个任务发表评论。
• 聊天视图评论：在团队聊天界面中集成评论功能。

架构改进

• 模块化设计：通过定义类型、服务和工具处理逻辑实现可扩展性。
• Open/Closed 原则：新增代码遵循开闭原则，便于维护和升级。

技术特点

1. 类型定义

• 定义了任务关系和评论的输入输出数据格式。
• 示例：

  export interface TaskDependency {
    taskId: string;
    dependentTaskId: string;
  }
  

2. 服务实现

• 实现了与 ClickUp API 的交互逻辑。
• 示例代码片段：

  public async createTaskDependency(taskId: string, dependentTaskId: string): Promise<void> {
    try {
      const url = `/tasks/${taskId}/dependencies`;
      await this.axiosInstance.post(url, { taskId: dependentTaskId });
    } catch (error) {
      console.error('创建任务依赖失败:', error);
      throw error;
    }
  }
  

原始功能

• 本地开发：使用 Node.js 和 TypeScript 开发。
• Railway 部署：通过 Railway 平台进行无服务器部署。

设置说明

本地开发步骤

1. 克隆代码库：

   git clone https://github.com/v4lheru/clickup-mcp-server.git
   cd clickup-mcp-server
   

2. 安装依赖：

   npm install
   

3. 配置环境变量：
   • 设置 CLICKUP_API_KEY 环境变量。
4. 启动服务器：

   npm run dev
   

Railway 部署步骤

1. 创建新应用并配置以下构建指令：

   npm install && npm run build
   

2. 配置运行时指令：

   npm start
   

3. 设置 CLICKUP_API_KEY 为密钥。

使用说明

连接 AI 助手

通过 RPC 或 HTTP 请求与您的 ClickUp 账户集成。

示例代码

// 创建任务依赖
await clickupMcp.createTaskDependency('task1', 'task2');

// 添加任务评论
await clickupMcp.addTaskComment('task1', '这是一个新的评论');

扩展服务器

新增 ClickUp API 工具

• 定义类型：

  export interface NewClickupTool {
    id: string;
    name: string;
    description: string;
  }
  

• 实现服务逻辑。

如果您有任何问题或需要进一步的帮助，请随时告诉我！