Trello MCP 서버(TypeScript)

Trello 통합을 위한 MCP(Model Context Protocol) 서버의 TypeScript 구현으로, AI 어시스턴트가 Trello 보드, 목록 및 카드와 상호 작용할 수 있는 도구를 제공합니다.

특징

MCP 도구를 통한 전체 Trello API 통합
더 나은 성능을 위한 비동기 작업
TypeScript를 사용한 유형 안전 구현
포괄적인 오류 처리
환경 기반 구성

Related MCP server: Claude MCP Trello

필수 조건

Node.js 18.x 이상
npm 또는 yarn
Trello API 자격 증명

설치

지엑스피1

구성

Trello 자격 증명을 사용하여 루트 디렉토리에 .env 파일을 만듭니다.

TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token

사용 가능한 명령

# Install dependencies
make install

# Build the project
make build

# Start the server
make start

# Clean build artifacts
make clean

# Run linter
make lint

MCP 도구

get_boards

인증된 사용자에 대한 모든 Trello 보드를 검색합니다.

// No input parameters required

get_lists

지정된 보드에서 모든 목록을 가져옵니다.

{
  "request": {
    "board_id": string // ID of the board
  }
}

카드를 받으세요

보드나 특정 목록에서 카드를 가져옵니다.

{
  "request": {
    "board_id": string,    // ID of the board
    "list_id"?: string     // Optional: ID of a specific list
  }
}

카드 세부 정보 받기

특정 카드에 대한 자세한 정보를 검색합니다.

{
  "request": {
    "card_id": string      // ID of the card
  }
}

개발

이 프로젝트는 타입 안전성과 더 나은 개발자 경험을 위해 TypeScript를 사용합니다. 소스 코드는 다음과 같이 구성되어 있습니다.

src/index.ts - 메인 서버 진입점
src/trello-client.ts - Trello API 클라이언트 구현
src/types.ts - TypeScript 유형 정의

건물

이 프로젝트는 다음을 빌드하기 위해 TypeScript 컴파일러를 사용합니다.

# Build the project
make build

# The output will be in the build/ directory

오류 처리

서버는 다음에 대한 포괄적인 오류 처리를 구현합니다.

API 인증 오류
속도 제한
네트워크 문제
잘못된 요청 매개변수

기여하다

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
브랜치에 푸시( git push origin feature/amazing-feature )
풀 리퀘스트 열기

Cline과 함께 사용

Cline과 함께 이 MCP 서버를 사용하려면 다음 구성을 Cline MCP 설정 파일( ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json )에 추가하세요.

{
  "mcpServers": {
    "trello-ts": {
      "command": "node",
      "args": ["/path/to/mcp-server-ts-trello/build/index.js"],
      "env": {
        "TRELLO_API_KEY": "your_api_key",
        "TRELLO_TOKEN": "your_token"
      }
    }
  }
}

구성을 추가하고 Cline을 다시 시작하면 다음 MCP 도구를 사용할 수 있습니다.