클로드 MCP 트렐로

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

특징

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

사용 가능한 도구

`trello_get_cards_by_list`

지정된 목록 ID에 포함된 카드 목록을 검색합니다.

지엑스피1

`trello_get_lists`

보드의 모든 목록을 검색합니다.

{
  name: "trello_get_lists",
  arguments: {}
}

`trello_get_recent_activity`

가장 최근의 보드 활동을 검색합니다. limit 인수는 검색할 개수를 지정할 수 있습니다(기본값: 10).

{
  name: "trello_get_recent_activity",
  arguments: {
    limit?: number; // Optional: number of activities to retrieve
  }
}

`trello_add_card`

지정된 목록에 카드를 추가합니다.

{
  name: "trello_add_card",
  arguments: {
    listId: string;       // The ID of the list to add to
    name: string;         // The title of the card
    description?: string; // Optional: details of the card
    dueDate?: string;     // Optional: due date (e.g., ISO8601)
    labels?: string[];    // Optional: array of label IDs
  }
}

`trello_update_card`

카드의 내용을 업데이트합니다.

{
  name: "trello_update_card",
  arguments: {
    cardId: string;       // The ID of the card to be updated
    name?: string;        // Optional: updated title
    description?: string; // Optional: updated description
    dueDate?: string;     // Optional: updated due date (e.g., ISO8601)
    labels?: string[];    // Optional: updated array of label IDs
  }
}

`trello_archive_card`

지정된 카드를 보관합니다(닫습니다).

{
  name: "trello_archive_card",
  arguments: {
    cardId: string; // The ID of the card to archive
  }
}

`trello_add_list`

보드에 새로운 목록을 추가합니다.

{
  name: "trello_add_list",
  arguments: {
    name: string; // Name of the new list
  }
}

`trello_archive_list`

지정된 목록을 보관합니다(닫습니다).

{
  name: "trello_archive_list",
  arguments: {
    listId: string; // The ID of the list to archive
  }
}

`trello_get_my_cards`

귀하의 계정과 관련된 모든 카드를 검색합니다.

{
  name: "trello_get_my_cards",
  arguments: {}
}

`trello_search_all_boards`

계획/권한에 따라 작업 공간(조직)의 모든 보드에서 교차 보드 검색을 수행합니다.

{
  name: "trello_search_all_boards",
  arguments: {
    query: string;   // Search keyword
    limit?: number;  // Optional: max number of results (default: 10)
  }
}

속도 제한

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

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

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

오류 처리

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

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

개발

필수 조건

Node.js 16 이상
npm 또는 yarn

설정

저장소를 복제합니다.
git clone https://github.com/hrs-asano/claude-mcp-trello.git cd claude-mcp-trello
종속성 설치:

npm install

프로젝트를 빌드하세요:

npm run build

테스트 실행

npm test

Claude Desktop과 통합

이 MCP 서버를 Claude Desktop과 통합하려면 다음 구성을 ~/Library/Application\Support/Claude/claude_desktop_config.json 파일에 추가하세요.

{
  "mcpServers": {
    "trello": {
      "command": "{YOUR_NODE_PATH}", // for example: /opt/homebrew/bin/node
      "args": [
        "{YOUR_PATH}/claude-mcp-trello/build/index.js"
      ],
      "env": {
        "TRELLO_API_KEY": "{YOUR_KEY}",
        "TRELLO_TOKEN": "{YOUR_TOKEN}",
        "TRELLO_BOARD_ID": "{YOUR_BOARD_ID}"
      }
    }
  }
}

{YOUR_NODE_PATH}, {YOUR_PATH}, {YOUR_KEY}, {YOUR_TOKEN}, {YOUR_BOARD_ID}를 사용자 환경에 적합한 값으로 바꿔야 합니다.

기여하다

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

특허

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

감사의 말

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

Claude MCP Trello

Integrations