trello-mcp-server

Trello MCP 서버

Trello API와 상호 작용하기 위한 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 일반 MCP 서버 템플릿을 기반으로 구축되었습니다.

특징

• Trello 통합 : Trello 보드, 목록, 카드 등에 대한 완벽한 액세스
• 포괄적인 API 범위 : 모든 주요 Trello 작업 지원
• 모듈형 아키텍처 : 명확하게 정의된 구조를 통해 관심사를 명확하게 분리
• 유형 안전성 : Trello 객체에 대한 적절한 타이핑을 통한 전체 TypeScript 지원
• 오류 처리 : 코드베이스 전체에 걸친 강력한 오류 관리

프로젝트 구조

지엑스피1

시작하기

필수 조건

• Node.js 18 이상
• npm 또는 yarn
• Trello API 키 및 토큰

설치

1. 이 저장소를 복제하세요:
   git clone https://github.com/yourusername/trello-mcp-server.git cd trello-mcp-server
2. 종속성 설치:
   npm install
3. .env.example 기반으로 .env 파일을 만듭니다.
   cp .env.example .env
4. Trello API 키와 토큰을 사용하여 .env 파일을 편집합니다.
   TRELLO_API_KEY=your_trello_api_key TRELLO_TOKEN=your_trello_token
   Trello 개발자 포털 에서 해당 정보를 얻을 수 있습니다.

건물과 운영

1. 프로젝트를 빌드하세요:
   npm run build
2. 서버를 실행합니다:
   npm start

사용 가능한 도구

이 서버는 모든 주요 Trello 리소스와 상호 작용하기 위한 도구를 제공합니다.

보드 도구

• get_boards - 인증된 사용자의 모든 보드를 가져옵니다.
• get_board - ID로 특정 보드 가져오기
• create_board - 새 보드 만들기
• update_board - 기존 보드 업데이트
• delete_board - 보드 삭제
• get_board_lists - 보드의 모든 목록을 가져옵니다
• get_board_members - 보드의 모든 멤버를 가져옵니다
• get_board_labels - 보드의 모든 라벨을 가져옵니다
• close_board - 게시판 닫기(보관)
• reopen_board - 닫힌 보드를 다시 엽니다

목록 도구

• get_list - ID로 특정 목록을 가져옵니다
• create_list - 보드에 새 목록을 만듭니다
• update_list - 기존 목록 업데이트
• archive_list - 목록 보관
• unarchive_list - 목록 보관 해제
• move_list_to_board - 목록을 다른 보드로 이동합니다.
• get_cards_in_list - 목록에 있는 모든 카드를 가져옵니다
• archive_all_cards - 목록에 있는 모든 카드를 보관합니다.
• move_all_cards - 목록에 있는 모든 카드를 다른 목록으로 이동합니다.
• update_list_position - 보드에서 목록의 위치를 업데이트합니다.
• update_list_name - 목록 이름 업데이트
• subscribe_to_list - 목록 구독

카드 도구

• get_card - ID로 특정 카드 가져오기
• create_card - 새 카드 만들기
• update_card - 기존 카드 업데이트
• delete_card - 카드 삭제
• archive_card - 카드 보관
• unarchive_card - 카드 보관 취소
• move_card_to_list - 카드를 다른 목록으로 이동합니다.
• add_comment - 카드에 댓글 추가
• get_comments - 카드에 대한 댓글 가져오기
• add_attachment - 카드에 첨부 파일 추가
• get_attachments - 카드에 첨부 파일 가져오기
• delete_attachment - 카드에서 첨부 파일 삭제
• add_member - 카드에 멤버 추가
• remove_member - 카드에서 멤버 제거
• add_label - 카드에 라벨을 추가합니다
• remove_label - 카드에서 라벨 제거
• set_due_date - 카드의 만기일을 설정합니다
• set_due_complete - 카드의 만기일을 완료 또는 미완료로 표시합니다.

회원 도구

• get_me - 인증된 멤버(현재 사용자)를 가져옵니다.
• get_member - ID 또는 사용자 이름으로 특정 회원 가져오기
• get_member_boards - 회원이 속한 보드를 가져옵니다.
• get_member_cards - 회원에게 할당된 카드 가져오기
• get_boards_invited - 멤버가 초대된 보드를 가져옵니다.
• get_member_organizations - 회원이 속한 조직을 가져옵니다.
• get_notifications - 인증된 회원에 대한 알림 받기
• update_me - 인증된 회원의 정보를 업데이트합니다.
• get_avatar - 인증된 회원의 아바타를 가져옵니다.
• search_members - 이름으로 멤버 검색
• get_board_members - 보드 멤버 얻기
• get_organization_members - 조직 구성원 가져오기
• get_card_members - 카드에 할당된 멤버 가져오기

라벨 도구

• get_label - ID로 특정 라벨 가져오기
• create_label - 보드에 새 라벨을 만듭니다.
• update_label - 기존 라벨 업데이트
• delete_label - 라벨 삭제
• get_board_labels - 보드의 모든 라벨을 가져옵니다
• update_label_name - 레이블 이름 업데이트
• update_label_color - 라벨 색상 업데이트
• create_label_on_card - 카드에 직접 새 라벨을 만듭니다.
• get_card_labels - 카드의 모든 라벨을 가져옵니다
• add_label_to_card - 카드에 라벨을 추가합니다.
• remove_label_from_card - 카드에서 라벨을 제거합니다.

체크리스트 도구

• get_checklist - ID로 특정 체크리스트 가져오기
• create_checklist - 카드에 새 체크리스트를 만듭니다.
• update_checklist - 기존 체크리스트 업데이트
• delete_checklist - 체크리스트 삭제
• get_checkitems - 체크리스트의 모든 체크 항목을 가져옵니다.
• create_checkitem - 체크리스트에 새로운 체크항목을 생성합니다.
• get_checkitem - 체크리스트의 특정 체크항목 가져오기
• update_checkitem - 체크리스트의 체크항목 업데이트
• delete_checkitem - 체크리스트에서 체크항목 삭제
• update_checklist_name - 체크리스트 이름 업데이트
• update_checklist_position - 카드에서 체크리스트의 위치를 업데이트합니다.
• get_checklist_board - 체크리스트가 있는 보드를 가져옵니다
• get_checklist_card - 체크리스트가 있는 카드를 가져옵니다
• update_checkitem_state_on_card - 카드의 체크 항목 상태를 업데이트합니다.

구성

서버는 src/config.ts 의 중앙 집중식 구성 시스템을 사용합니다. 구성은 다음을 통해 제공될 수 있습니다.

• 환경 변수
• 명령줄 인수( --env KEY=VALUE 사용)
• 코드의 기본값

필수 환경 변수:

• TRELLO_API_KEY - Trello API 키
• TRELLO_TOKEN - Trello API 토큰

오류 처리

서버에는 포괄적인 오류 처리 기능이 포함되어 있습니다.

• 속도 제한 지원을 통한 서비스 수준 오류 처리
• 적절한 오류 메시지를 통한 도구 수준 오류 처리
• MCP 프로토콜 오류 처리
• Trello API 오류 처리

특허

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