Trello MCP 서버
Trello API와 상호 작용하기 위한 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 일반 MCP 서버 템플릿을 기반으로 구축되었습니다.
특징
Trello 통합 : Trello 보드, 목록, 카드 등에 대한 완벽한 액세스
포괄적인 API 범위 : 모든 주요 Trello 작업 지원
모듈형 아키텍처 : 명확하게 정의된 구조를 통해 관심사를 명확하게 분리
유형 안전성 : Trello 객체에 대한 적절한 타이핑을 통한 전체 TypeScript 지원
오류 처리 : 코드베이스 전체에 걸친 강력한 오류 관리
Related MCP server: MCP Server Trello
프로젝트 구조
지엑스피1
시작하기
필수 조건
Node.js 18 이상
npm 또는 yarn
Trello API 키 및 토큰
설치
이 저장소를 복제하세요:
git clone https://github.com/yourusername/trello-mcp-server.git cd trello-mcp-server종속성 설치:
npm install.env.example기반으로.env파일을 만듭니다.cp .env.example .envTrello API 키와 토큰을 사용하여
.env파일을 편집합니다.TRELLO_API_KEY=your_trello_api_key TRELLO_TOKEN=your_trello_tokenTrello 개발자 포털 에서 해당 정보를 얻을 수 있습니다.
건물과 운영
프로젝트를 빌드하세요:
npm run build서버를 실행합니다:
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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.