MCP 서버 Trello

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

변경 사항

0.3.0

보드 및 작업 공간 관리 기능이 추가되었습니다.
- list_boards - 사용자가 액세스할 수 있는 모든 보드를 나열합니다.
- set_active_board - 향후 작업을 위해 활성 보드를 설정합니다.
- list_workspaces - 사용자가 액세스할 수 있는 모든 작업 공간 나열
- set_active_workspace - 향후 작업을 위한 활성 작업 공간 설정
- list_boards_in_workspace - 특정 작업 공간에 있는 모든 보드를 나열합니다.
- get_active_board_info - 현재 활성화된 보드에 대한 정보를 가져옵니다.
활성 보드/작업 공간을 기억하기 위해 영구 구성 저장소를 추가했습니다.
모든 새로운 작업에 대한 오류 처리가 개선되었습니다.

0.2.1

비율 제한기 함수에 자세한 JSDoc 주석을 추가했습니다.
이미지 첨부 기능에 대한 오류 처리가 개선되었습니다.
attach_image_to_card 도구에 대한 업데이트된 설명서

0.2.0

URL에서 카드에 이미지를 첨부하기 위해 attach_image_to_card 도구가 추가되었습니다.
다단계 빌드로 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 파일을 생성하세요.

# Required: Your Trello API credentials
TRELLO_API_KEY=your-api-key
TRELLO_TOKEN=your-token

# Required: Initial board ID (can be changed later using set_active_board)
TRELLO_BOARD_ID=your-board-id

# Optional: Initial workspace ID (can be changed later using set_active_workspace)
TRELLO_WORKSPACE_ID=your-workspace-id

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

API 키: https://trello.com/app-key
토큰: API 키를 사용하여 생성
게시판 ID: 게시판 URL에서 찾을 수 있습니다(예: https://trello.com/b/BOARD\_ID/board-name )
작업 공간 ID: 작업 공간 설정에서 찾거나 list_workspaces 도구를 사용하여 찾음

보드 및 작업 공간 관리

버전 0.3.0부터 MCP 서버는 동적 보드 및 작업 공간 선택을 지원합니다.

.env 파일의 TRELLO_BOARD_ID 는 서버가 시작될 때 초기 보드 ID로 사용됩니다.
set_active_board 도구를 사용하여 언제든지 활성 보드를 변경할 수 있습니다.
선택된 보드는 서버를 다시 시작할 때까지 유지됩니다( ~/.trello-mcp/config.json 에 저장됨)
마찬가지로 set_active_workspace 사용하여 활성 작업 공간을 설정하고 유지할 수 있습니다.

이를 통해 서버를 다시 시작하거나 환경 변수를 변경하지 않고도 여러 보드와 작업 공간에서 작업할 수 있습니다.

워크플로 예시

먼저 사용 가능한 보드를 나열해 보세요.

{
  name: 'list_boards',
  arguments: {}
}

활성 보드 설정:

{
  name: 'set_active_board',
  arguments: {
    boardId: "abc123"  // ID from list_boards response
  }
}

필요한 경우 작업 공간을 나열하세요.

{
  name: 'list_workspaces',
  arguments: {}
}

필요한 경우 활성 작업 공간을 설정합니다.

{
  name: 'set_active_workspace',
  arguments: {
    workspaceId: "xyz789"  // ID from list_workspaces response
  }
}

현재 활성 보드 정보를 확인하세요:

{
  name: 'get_active_board_info',
  arguments: {}
}

사용 가능한 도구

목록_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
  }
}

카드에 이미지를 첨부하세요

URL에서 카드에 이미지를 직접 첨부합니다.

{
  name: 'attach_image_to_card',
  arguments: {
    cardId: string,  // ID of the card to attach the image to
    imageUrl: string, // URL of the image to attach
    name?: string    // Optional: Name for the attachment (defaults to "Image Attachment")
  }
}

리스트_보드

사용자가 접근할 수 있는 모든 보드를 나열합니다.

{
  name: 'list_boards',
  arguments: {}
}

활성_보드 설정

향후 작업을 위해 활성 보드를 설정합니다.

{
  name: 'set_active_board',
  arguments: {
    boardId: string  // ID of the board to set as active
  }
}

작업공간 목록

사용자가 액세스할 수 있는 모든 작업 공간을 나열합니다.

{
  name: 'list_workspaces',
  arguments: {}
}

활성 작업공간 설정

향후 작업을 위해 활성 작업 공간을 설정합니다.

{
  name: 'set_active_workspace',
  arguments: {
    workspaceId: string  // ID of the workspace to set as active
  }
}

작업 공간의 리스트보드

특정 작업 공간에 있는 모든 보드를 나열합니다.

{
  name: 'list_boards_in_workspace',
  arguments: {
    workspaceId: string  // ID of the workspace to list boards from
  }
}

활성 보드 정보 얻기

현재 활동 중인 게시판에 대한 정보를 얻으세요.

{
  name: 'get_active_board_info',
  arguments: {}
}

속도 제한

서버는 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를 사용합니다

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Trello API를 통해 Trello 보드와의 상호 작용을 용이하게 하며, 카드, 목록 및 보드 활동을 원활하게 관리하기 위한 속도 제한, 유형 안전, 입력 검증 및 오류 처리와 같은 기능을 제공합니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Trello MCP Server
andypost
A
security
F
license
A
quality
Enables interaction with Trello boards, lists, and cards through Model Context Protocol (MCP) tools, leveraging TypeScript for type safety and asynchronous operations.
Last updated -
5
JavaScript
Claude MCP Trello
hrs-asano
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for interacting with Trello boards, enabling seamless management of cards, lists, and activities while handling rate limiting and type safety.
Last updated -
10
3
JavaScript
MIT License
trello-mcp-server
v4lheru
-
security
A
license
-
quality
Connects to Trello with all the tools available that I was able to find in API reference
Last updated -
3
1
TypeScript
MIT License
MCP Server Trello
diegofornalha
A
security
A
license
A
quality
Enables seamless integration with Trello boards, allowing users to manage cards, lists, and activities while automatically handling rate limiting and providing type safety.
Last updated -
9
TypeScript
MIT License

View all related MCP servers