MCP 서버 Trello

Trello 보드와 상호 작용하기 위한 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 속도 제한, 유형 안전성 및 오류 처리를 자동으로 처리하면서 Trello API와의 원활한 통합을 지원합니다.

변경 사항

0.1.2

다단계 빌드로 Docker 지원 추가
환경 변수를 .env 로 이동하여 보안을 강화했습니다.
Docker Compose 구성이 추가되었습니다.
더 쉬운 설정을 위해 .env.template 추가했습니다.

0.1.1

목록 간에 카드를 이동하기 위한 move_card 도구가 추가되었습니다.
개선된 문서화

0.1.0

기본 Trello 보드 관리 기능이 포함된 초기 릴리스

특징

전체 Trello 보드 통합 : 카드, 목록 및 보드 활동과 상호 작용
내장된 속도 제한 : Trello의 API 제한(API 키당 300개 요청/10초, 토큰당 100개 요청/10초)을 준수합니다.
유형 안전 구현 : 포괄적인 유형 정의를 사용하여 TypeScript로 작성됨
입력 검증 : 모든 API 입력에 대한 강력한 검증
오류 처리 : 정보성 메시지를 통한 우아한 오류 처리

설치

Docker 설치(권장)

서버를 실행하는 가장 쉬운 방법은 Docker를 사용하는 것입니다.

저장소를 복제합니다.

지엑스피1

환경 템플릿을 복사하고 Trello 자격 증명을 입력하세요.

cp .env.template .env

Docker Compose로 빌드하고 실행하세요.

docker compose up --build

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Trello Server를 자동으로 설치하려면:

npx -y @smithery/cli install @modelcontextprotocol/mcp-server-trello --client claude

수동 설치

npm install @delorenj/mcp-server-trello

구성

환경 변수를 사용하여 서버를 구성할 수 있습니다. 루트 디렉터리에 다음 변수를 사용하여 .env 파일을 생성하세요.

TRELLO_API_KEY=your-api-key
TRELLO_TOKEN=your-token
TRELLO_BOARD_ID=your-board-id

다음에서 이러한 값을 얻을 수 있습니다.

API 키: https://trello.com/app-key
토큰: API 키를 사용하여 생성
게시판 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: {}
}

이동_카드

카드를 다른 목록으로 이동합니다.

{
  name: 'move_card',
  arguments: {
    cardId: string,  // ID of the card to move
    listId: string   // ID of the target list
  }
}

속도 제한

서버는 Trello의 API 제한을 준수하기 위해 속도 제한을 위한 토큰 버킷 알고리즘을 구현합니다.

API 키당 10초당 300개 요청
토큰당 10초당 100개의 요청

속도 제한은 자동으로 처리되며, 제한에 도달하면 요청이 대기열에 추가됩니다.

오류 처리

서버는 다양한 시나리오에 대한 자세한 오류 메시지를 제공합니다.

잘못된 입력 매개변수
요금 제한을 초과했습니다
API 인증 오류
네트워크 문제
잘못된 보드/목록/카드 ID입니다.

개발

필수 조건

Node.js 16 이상
npm 또는 yarn

설정

저장소를 복제합니다

git clone https://github.com/delorenj/mcp-server-trello
cd mcp-server-trello

종속성 설치

npm install

프로젝트를 빌드하세요

npm run build

기여하다

기여를 환영합니다!

특허

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

감사의 말

모델 컨텍스트 프로토콜 SDK 로 구축됨
Trello REST API를 사용합니다

MCP Server Trello

Integrations