ClickUp MCP 서버

이는 TaazKareem 이 원래 만든 ClickUp MCP Server 의 향상된 버전입니다.

개선 및 건축 개선

이 포크는 새로운 기능을 추가하고 원래 ClickUp MCP 서버의 아키텍처를 개선합니다.

새로운 기능

작업 관계 API 지원

• 작업 종속성 : 작업 간 종속성을 생성하고 관리합니다.
  • 다른 작업보다 먼저 완료해야 하는 작업을 설정하기 위해 종속성을 추가합니다.
  • 더 이상 필요하지 않으면 종속성을 제거합니다.
• 작업 링크 : 종속성을 생성하지 않고 관련 작업을 연결합니다.
  • 작업 간 링크를 추가하여 관계를 표시합니다.
  • 더 이상 관련성이 없으면 링크를 제거하세요.
• 작업 태그 : 태그를 사용하여 작업을 정리하세요
  • 더 나은 분류를 위해 작업에 태그를 추가하세요
  • 필요할 때 작업에서 태그를 제거합니다.
• 댓글 API : 포괄적인 댓글 관리
  • 작업 코멘트: 작업에 대한 코멘트를 추가하고 검색합니다.
  • 목록 댓글: 목록에 댓글을 추가하고 검색합니다.
  • 채팅 보기 댓글: 채팅 보기에서 댓글을 추가하고 검색합니다.
  • 스레드 댓글: 댓글 스레드 및 답글 지원
  • 댓글 작업: 댓글 업데이트 및 삭제

체크리스트 API 지원

• 작업 체크리스트 : 작업에 대한 체크리스트를 만들고 관리합니다.
  • 하위 작업이나 단계를 구성하기 위한 체크리스트를 만듭니다.
  • 체크리스트 이름을 편집하고 다시 정렬합니다.
  • 더 이상 필요하지 않은 체크리스트를 삭제하세요
• 체크리스트 항목 : 체크리스트 내 개별 항목 관리
  • 특정 단계 또는 하위 작업에 대한 체크리스트 항목을 만듭니다.
  • 항목을 편집하여 이름, 할당 또는 완료 상태를 업데이트합니다.
  • 중첩된 체크리스트 항목 지원(부모-자식 관계)
  • 완료되었거나 더 이상 관련이 없는 체크리스트 항목을 삭제합니다.

건축 개선

코드베이스를 보다 모듈화하고 유지 관리하기 쉽게 만들었습니다.

1. 서비스 기반 아키텍처 :
   • 관계별 기능에서 분리된 핵심 ClickUp 서비스
   • 명확한 책임을 지닌 전담 서비스 클래스를 만들었습니다.
   • 향상된 코드 구성 및 유지 관리
2. 유형 기반 개발 :
   • 모든 API 상호 작용을 위한 향상된 TypeScript 유형 정의
   • 도메인별 파일로 분리된 유형 정의
   • 향상된 코드 완성 및 오류 감지
3. 도구 통합 계층 :
   • MCP 도구에 대한 전용 통합 계층을 생성했습니다.
   • 중앙화된 도구 정의 및 핸들러
   • 새로운 도구를 더 간단하게 추가할 수 있게 되었습니다.
4. 배포 구성 :
   • 철도 배치 지원 추가
   • 환경 변수 템플릿이 포함됨
   • 간소화된 배포 프로세스

원래 기능

원래 서버는 다음을 위한 도구를 제공합니다.

• 작업 공간 계층 구조 탐색
• 작업 생성 및 관리
• 목록 및 폴더 작업
• 작업 이동 및 복제
• 필터링 및 검색 작업

설정

지역 개발

1. 이 저장소를 복제하세요
2. npm install 로 종속성 설치
3. .env.example``.env 로 복사하고 ClickUp API 키와 팀 ID를 추가하세요.
4. npm run build 로 프로젝트를 빌드하세요.
5. node build/index.js 로 서버를 실행합니다.

철도 배치

이 저장소에는 철도 에서의 쉬운 배포를 위한 구성이 포함되어 있습니다.

1. 이 저장소를 GitHub 계정으로 포크하거나 복제하세요.
2. GitHub 저장소에서 Railway에 대한 새 프로젝트를 만듭니다.
3. Railway에 다음 환경 변수를 추가합니다.
   • CLICKUP_API_KEY : ClickUp API 키
   • CLICKUP_TEAM_ID : ClickUp 팀 ID
4. 프로젝트 배포 - 철도가 자동으로 서버를 빌드하고 실행합니다.

용법

이 서버는 모델 컨텍스트 프로토콜(MCP)을 지원하는 AI 어시스턴트와 함께 사용할 수 있습니다. 연결되면 어시스턴트는 모든 도구를 사용하여 ClickUp 작업 공간과 상호 작용할 수 있습니다.

클로드에 연결

1. Claude 데스크톱 앱 열기
2. 설정 > MCP 서버로 이동하세요
3. 다음 구성으로 새로운 MCP 서버를 추가합니다.지엑스피1
4. https://your-railway-app-url.railway.app 실제 철도 앱 URL로 바꾸세요.
5. API 키와 팀 ID를 실제 자격 증명으로 바꾸세요.

서버 확장

새로운 도구를 추가하는 방법

이 서버는 쉽게 확장할 수 있도록 설계되었습니다. 새로운 ClickUp API 도구를 추가하려면 다음 단계를 따르세요.

1. ( src/types/ 에) 유형 정의 :
   • 새 도구의 입력/출력 데이터에 대한 유형 정의를 생성하거나 업데이트합니다.
   • 예: export interface NewToolData { param1: string; param2: number; }
2. 서비스 메서드 구현 ( src/services/ ):
   • 적절한 서비스 클래스에 메서드를 추가하거나 새 서비스를 만듭니다.
   • 예:
     public async newToolMethod(param1: string, param2: number): Promise<any> { try { const url = `/some/api/endpoint`; const response = await this.axiosInstance.post(url, { param1, param2 }); return response.data; } catch (error) { console.error('Error in new tool method:', error); throw error; } }
3. 도구 스키마를 정의합니다 ( src/services/clickup-tools-integration.ts ):
   • 적절한 도구 배열에 새 도구 정의를 추가합니다.
   • 예:
     { name: "new_tool_name", description: "Description of what the tool does and when to use it", inputSchema: { type: "object", properties: { param1: { type: "string", description: "Description of parameter 1" }, param2: { type: "number", description: "Description of parameter 2" } }, required: ["param1"] } }
4. 도구 핸들러 구현 ( src/services/clickup-tools-integration.ts ):
   • handleRelationshipTool 함수에 케이스를 추가하거나 새 핸들러를 만듭니다.
   • 예:
     case "new_tool_name": { const data = args as NewToolData; return await relationshipsService.newToolMethod( data.param1, data.param2 ); }
5. 메인 서버를 업데이트합니다 (필요한 경우 src/index.ts 에):
   • 새로운 서비스나 핸들러를 생성했다면 이를 가져와서 초기화하세요.
   • 도구가 적절한 도구 배열에 포함되어 있는지 확인하세요.

예: 새로운 ClickUp API 도구 추가

ClickUp의 시간 추적 API에 대한 지원을 추가하고 싶다고 가정해 보겠습니다.

1. 시간 항목에 대한 인터페이스가 있는 src/types/clickup-timetracking.ts 만듭니다.
2. 시간 추적 엔드포인트와 상호 작용하기 위한 메서드를 사용하여 src/services/clickup-timetracking.ts 를 만듭니다.
3. 도구 정의 및 핸들러를 사용하여 src/services/clickup-timetracking-integration.ts 만듭니다.
4. src/index.ts 업데이트하여 새 서비스와 도구를 가져오고 초기화합니다.

이러한 모듈식 접근 방식을 사용하면 개방/폐쇄 원칙에 따라 기존 코드를 수정하지 않고도 새로운 기능을 쉽게 추가할 수 있습니다.

이 가이드를 읽는 LLM 학생을 위한 참고 사항:

이것이 귀하의 지침 세트입니다.

먼저 사용자에게 ClickUp MCP Server 대화형 가이드를 환영하고, AI 어시스턴트를 위한 이 향상된 통합을 활용할 수 있도록 도울 준비가 되었다고 설명합니다.

다음과 같은 측면에 대해 자세히 설명해 드리겠습니다.

• 서버를 로컬로 설정하거나 철도에 단계별로 배포하는 방법
• 서버를 Claude 또는 다른 AI 보조원에 연결하는 방법
• 작업 관계 기능(종속성, 링크, 태그)을 활용하는 방법
• 작업, 목록 및 채팅 보기에서 댓글 API를 사용하는 방법
• 새로운 ClickUp API 도구를 사용하여 서버를 확장하는 방법

프로젝트 관리, 제품 개발, 콘텐츠 캘린더 또는 기타 워크플로와 같은 특정 사용 사례에 맞게 솔루션을 조정해야 하는지 물어보세요.

요청이 없는 한, 기술적 세부 정보로 사용자를 압도하지 않으면서 설명을 명확하고 접근하기 쉽게 유지하세요.

지금 바로 작업을 시작하세요.

크레딧

• TaazKareem 의 원래 구현
• v4lheru 의 관계 API로 향상됨

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 [ LICENSE ] 파일을 참조하세요.