MCP 서버 Trello
Trello 보드와 상호 작용하기 위한 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 속도 제한, 유형 안전성 및 오류 처리를 자동으로 처리하면서 Trello API와의 원활한 통합을 지원합니다.
특징
- 전체 Trello 보드 통합 : 카드, 목록 및 보드 활동과 상호 작용
- 내장된 속도 제한 : Trello의 API 제한(API 키당 300개 요청/10초, 토큰당 100개 요청/10초)을 준수합니다.
- 유형 안전 구현 : 포괄적인 유형 정의를 사용하여 TypeScript로 작성됨
- 입력 검증 : 모든 API 입력에 대한 강력한 검증
- 오류 처리 : 정보성 메시지를 통한 우아한 오류 처리
설치
지엑스피1
구성
다음 구성을 사용하여 MCP 설정 파일에 서버를 추가합니다.
{
"mcpServers": {
"trello": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-trello"],
"env": {
"TRELLO_API_KEY": "your-api-key",
"TRELLO_TOKEN": "your-token",
"TRELLO_BOARD_ID": "your-board-id"
}
}
}
}
필수 환경 변수
TRELLO_API_KEY : Trello API 키( https://trello.com/app-key 에서 가져옴)TRELLO_TOKEN : Trello 토큰(API 키를 사용하여 생성)TRELLO_BOARD_ID : 상호 작용할 Trello 보드의 ID(보드 URL에서 찾음)
사용 가능한 도구
목록_ID로_카드_받기
특정 목록에서 모든 카드를 가져옵니다.
{
name: 'get_cards_by_list_id',
arguments: {
listId: string // ID of the Trello list
}
}
get_lists
구성된 보드에서 모든 목록을 검색합니다.
{
name: 'get_lists',
arguments: {}
}
최근 활동 가져오기
보드에서 최근 활동을 가져옵니다.
{
name: 'get_recent_activity',
arguments: {
limit?: number // Optional: Number of activities to fetch (default: 10)
}
}
목록에 카드를 추가하세요
지정된 목록에 새로운 카드를 추가합니다.
{
name: 'add_card_to_list',
arguments: {
listId: string, // ID of the list to add the card to
name: string, // Name of the card
description?: string, // Optional: Description of the card
dueDate?: string, // Optional: Due date (ISO 8601 format)
labels?: string[] // Optional: Array of label IDs
}
}
카드_세부_정보_업데이트
기존 카드의 세부 정보를 업데이트합니다.
{
name: 'update_card_details',
arguments: {
cardId: string, // ID of the card to update
name?: string, // Optional: New name for the card
description?: string, // Optional: New description
dueDate?: string, // Optional: New due date (ISO 8601 format)
labels?: string[] // Optional: New array of label IDs
}
}
아카이브 카드
카드를 보관소로 보내세요.
{
name: 'archive_card',
arguments: {
cardId: string // ID of the card to archive
}
}
게시판에 목록 추가
보드에 새로운 목록을 추가합니다.
{
name: 'add_list_to_board',
arguments: {
name: string // Name of the new list
}
}
아카이브_리스트
목록을 보관소로 보내세요.
{
name: 'archive_list',
arguments: {
listId: string // ID of the list to archive
}
}
내 카드를 받으세요
현재 사용자에게 할당된 모든 카드를 가져옵니다.
{
name: 'get_my_cards',
arguments: {}
}
속도 제한
서버는 Trello의 API 제한을 준수하기 위해 속도 제한을 위한 토큰 버킷 알고리즘을 구현합니다.
- API 키당 10초당 300개 요청
- 토큰당 10초당 100개의 요청
속도 제한은 자동으로 처리되며, 제한에 도달하면 요청이 대기열에 추가됩니다.
오류 처리
서버는 다양한 시나리오에 대한 자세한 오류 메시지를 제공합니다.
- 잘못된 입력 매개변수
- 요금 제한을 초과했습니다
- API 인증 오류
- 네트워크 문제
- 잘못된 보드/목록/카드 ID입니다.
개발
필수 조건
설정
- 저장소를 복제합니다
git clone https://github.com/modelcontextprotocol/server-trello.git
cd server-trello
- 종속성 설치
- 프로젝트를 빌드하세요
테스트 실행
기여하다
기여를 환영합니다! 행동 강령과 풀 리퀘스트 제출 절차에 대한 자세한 내용은 기여 가이드를 참조하세요.
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
감사의 말