Integrations

Enables comprehensive Trello board management with capabilities for interacting with cards, lists, and board activities. Supports creating and updating cards, managing lists, tracking recent activity, and handling assigned tasks while respecting Trello's API rate limits.

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입니다.

개발

필수 조건

Node.js 16 이상
npm 또는 yarn

설정

저장소를 복제합니다

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

종속성 설치

npm install

프로젝트를 빌드하세요

npm run build

테스트 실행

npm test

기여하다

기여를 환영합니다! 행동 강령과 풀 리퀘스트 제출 절차에 대한 자세한 내용은 기여 가이드를 참조하세요.

특허

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

감사의 말

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

Trello 보드와 완벽하게 통합되어 사용자가 카드, 목록, 활동을 관리하고 자동으로 속도 제한을 처리하며 유형 안전성을 제공할 수 있습니다.

Related Resources

Reddit Discussion about this server

MCP Server Trello