ClickUp MCP Server测评：连接AI与项目管理的智能桥梁

# 1. 克隆项目仓库
git clone https://github.com/TaazKareem/clickup-mcp-server.git
cd clickup-mcp-server

# 2. 安装依赖
npm install

# 3. 配置环境变量
# 在项目根目录创建.env文件，添加以下内容：
# CLICKUP_API_KEY=你的API密钥
# CLICKUP_TEAM_ID=你的团队ID

# 4. 编译TypeScript代码
npm run build

# 5. 启动服务
npm start

# 在终端中执行以上相同步骤，如遇到权限问题可尝试：
sudo chmod -R 755 clickup-mcp-server

# 清除npm缓存并重新安装
npm cache clean --force
rm -rf node_modules
npm install

# 查找占用端口的进程
netstat -ano | findstr :3000
# 终止相关进程或更改应用端口

{
  "servers": [
    {
      "name": "clickup",
      "command": "npx",
      "args": ["-y", "clickup-mcp-server"],
      "env": {
        "CLICKUP_API_KEY": "你的API密钥",
        "CLICKUP_TEAM_ID": "你的团队ID"
      }
    }
  ]
}

// clickup-demo.js - ClickUp MCP Server使用示例
const { ClickUpClient } = require('clickup-mcp-server');

class ClickUpManager {
  constructor(apiKey) {
    this.client = new ClickUpClient(apiKey);
  }
  
  // 查询指定团队的本周高优先级任务
  async getHighPriorityTasks(teamId) {
    try {
      // 获取团队的工作区
      const workspaces = await this.client.getWorkspaces();
      const teamWorkspace = workspaces.find(ws => ws.teamId === teamId);
      
      if (!teamWorkspace) {
        throw new Error(`未找到ID为${teamId}的团队工作区`);
      }
      
      // 获取空间和列表
      const spaces = await this.client.getSpaces(teamWorkspace.id);
      const tasks = [];
      
      for (const space of spaces) {
        const lists = await this.client.getLists(space.id);
        
        for (const list of lists) {
          // 查询未完成的高优先级任务
          const listTasks = await this.client.getTasks(list.id, {
            status: 'incomplete',
            priority: 'high',
            due_date_gt: new Date().getTime() - 7*24*60*60*1000 // 最近7天
          });
          
          tasks.push(...listTasks);
        }
      }
      
      return tasks;
    } catch (error) {
      console.error('查询任务时出错:', error.message);
      return [];
    }
  }
  
  // 更新任务分配
  async assignTask(taskId, assigneeId) {
    try {
      const updateData = {
        assignees: [assigneeId]
      };
      
      const result = await this.client.updateTask(taskId, updateData);
      console.log(`任务 ${taskId} 已分配给用户 ${assigneeId}`);
      return result;
    } catch (error) {
      console.error('分配任务时出错:', error.message);
      throw error;
    }
  }
}

// 使用示例
async function main() {
  const apiKey = process.env.CLICKUP_API_KEY;
  const teamId = process.env.CLICKUP_TEAM_ID;
  
  const clickupManager = new ClickUpManager(apiKey);
  
  // 获取高优先级任务
  const highPriorityTasks = await clickupManager.getHighPriorityTasks(teamId);
  console.log(`找到 ${highPriorityTasks.length} 个高优先级任务`);
  
  // 将第一个任务分配给指定成员
  if (highPriorityTasks.length > 0) {
    const targetTask = highPriorityTasks[0];
    await clickupManager.assignTask(targetTask.id, '目标成员ID');
  }
}

// 执行演示
if (require.main === module) {
  main();
}