클로드 MCP 트렐로
Trello 보드와 상호 작용하기 위한 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 속도 제한, 유형 안전성 및 오류 처리를 자동으로 처리하면서 Trello API와의 원활한 통합을 지원합니다.
특징
전체 Trello 보드 통합 : 카드, 목록 및 보드 활동과 상호 작용
내장된 속도 제한 : Trello의 API 제한(API 키당 300개 요청/10초, 토큰당 100개 요청/10초)을 준수합니다.
유형 안전 구현 : 포괄적인 유형 정의를 사용하여 TypeScript로 작성됨
입력 검증 : 모든 API 입력에 대한 강력한 검증
오류 처리 : 정보성 메시지를 통한 우아한 오류 처리
Related MCP server: Trello MCP Server with Python
사용 가능한 도구
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 testClaude 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를 사용합니다
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.