Trello MCP サーバー

Trello API と連携するためのツールを提供するモデルコンテキストプロトコル (MCP) サーバー。汎用 MCP サーバーテンプレートに基づいて構築されています。

特徴

Trello 統合: Trello ボード、リスト、カードなどへの完全なアクセス
包括的なAPIカバレッジ：すべての主要なTrello操作をサポート
モジュラーアーキテクチャ：明確に定義された構造による関心事の明確な分離
型安全性: Trello オブジェクトの適切な型付けによる完全な TypeScript サポート
エラー処理: コードベース全体にわたる堅牢なエラー管理

プロジェクト構造

trello-mcp-server/
├── src/
│   ├── services/       # Service classes for Trello API interactions
│   │   ├── base-service.ts        # Abstract base service with common functionality
│   │   ├── trello-service.ts      # Core Trello API service
│   │   ├── board-service.ts       # Service for Trello boards
│   │   ├── list-service.ts        # Service for Trello lists
│   │   ├── card-service.ts        # Service for Trello cards
│   │   ├── member-service.ts      # Service for Trello members
│   │   ├── label-service.ts       # Service for Trello labels
│   │   ├── checklist-service.ts   # Service for Trello checklists
│   │   └── service-factory.ts     # Factory for creating service instances
│   ├── tools/          # MCP tool definitions and handlers
│   │   ├── board-tools.ts         # Board tool definitions
│   │   ├── board-tool-handlers.ts # Board tool handlers
│   │   ├── list-tools.ts          # List tool definitions
│   │   ├── list-tool-handlers.ts  # List tool handlers
│   │   ├── card-tools.ts          # Card tool definitions
│   │   ├── card-tool-handlers.ts  # Card tool handlers
│   │   ├── member-tools.ts        # Member tool definitions
│   │   ├── member-tool-handlers.ts # Member tool handlers
│   │   ├── label-tools.ts         # Label tool definitions
│   │   ├── label-tool-handlers.ts # Label tool handlers
│   │   ├── checklist-tools.ts     # Checklist tool definitions
│   │   ├── checklist-tool-handlers.ts # Checklist tool handlers
│   │   ├── trello-tools.ts        # Combined tool definitions
│   │   └── trello-tool-handlers.ts # Combined tool handlers
│   ├── types/          # TypeScript type definitions
│   │   └── trello-types.ts        # Trello type definitions
│   ├── config.ts       # Configuration management
│   └── index.ts        # Main entry point
├── .env.example        # Example environment variables
├── package.json        # Project dependencies and scripts
├── tsconfig.json       # TypeScript configuration
└── README.md           # Project documentation

はじめる

前提条件

Node.js 18以上
npmまたはyarn
Trello APIキーとトークン

インストール

このリポジトリをクローンします:

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

依存関係をインストールします:
```
npm install
```
.env.exampleに基づいて.envファイルを作成します。
```
cp .env.example .env
```
Trello API キーとトークンを使用して.envファイルを編集します。
```
TRELLO_API_KEY=your_trello_api_key
TRELLO_TOKEN=your_trello_token
```
これらはTrello 開発者ポータルから入手できます。

構築と実行

プロジェクトをビルドします。
```
npm run build
```
サーバーを実行します。
```
npm start
```

利用可能なツール

サーバーは、すべての主要な Trello リソースと対話するためのツールを提供します。

ボードツール

get_boards - 認証されたユーザーのすべてのボードを取得します
get_board - IDで特定のボードを取得する
create_board - 新しいボードを作成する
update_board - 既存のボードを更新する
delete_board - ボードを削除する
get_board_lists - ボード上のすべてのリストを取得する
get_board_members - ボードのメンバー全員を取得する
get_board_labels - ボード上のすべてのラベルを取得する
close_board - ボードを閉じる（アーカイブする）
reopen_board - 閉じたボードを再度開く

リストツール

get_list - IDで特定のリストを取得する
create_list - ボードに新しいリストを作成する
update_list - 既存のリストを更新する
archive_list - リストをアーカイブする
unarchive_list - リストをアーカイブ解除する
move_list_to_board - リストを別のボードに移動する
get_cards_in_list - リスト内のすべてのカードを取得する
archive_all_cards - リスト内のすべてのカードをアーカイブする
move_all_cards - リスト内のすべてのカードを別のリストに移動する
update_list_position - ボード上のリストの位置を更新する
update_list_name - リストの名前を更新する
subscribe_to_list - リストを購読する

カードツール

get_card - IDで特定のカードを取得する
create_card - 新しいカードを作成する
update_card - 既存のカードを更新する
delete_card - カードを削除する
archive_card - カードをアーカイブする
unarchive_card - カードをアーカイブ解除する
move_card_to_list - カードを別のリストに移動する
add_comment - カードにコメントを追加する
get_comments - カードのコメントを取得する
add_attachment - カードに添付ファイルを追加する
get_attachments - カードの添付ファイルを取得する
delete_attachment - カードから添付ファイルを削除する
add_member - カードにメンバーを追加する
remove_member - カードからメンバーを削除する
add_label - カードにラベルを追加する
remove_label - カードからラベルを削除する
set_due_date - カードの期限を設定する
set_due_complete - カードの期限を完了または未完了としてマークする

メンバーツール

get_me - 認証されたメンバー（現在のユーザー）を取得する
get_member - IDまたはユーザー名で特定のメンバーを取得する
get_member_boards - メンバーが所属するボードを取得する
get_member_cards - メンバーに割り当てられたカードを取得する
get_boards_invited - メンバーが招待されたボードを取得する
get_member_organizations - メンバーが所属する組織を取得する
get_notifications - 認証されたメンバーの通知を取得する
update_me - 認証されたメンバーの情報を更新する
get_avatar - 認証されたメンバーのアバターを取得する
search_members - 名前でメンバーを検索
get_board_members - ボードのメンバーを取得する
get_organization_members - 組織のメンバーを取得する
get_card_members - カードに割り当てられたメンバーを取得する

ラベルツール

get_label - IDで特定のラベルを取得する
create_label - ボードに新しいラベルを作成する
update_label - 既存のラベルを更新する
delete_label - ラベルを削除する
get_board_labels - ボード上のすべてのラベルを取得する
update_label_name - ラベルの名前を更新する
update_label_color - ラベルの色を更新する
create_label_on_card - カードに直接新しいラベルを作成します
get_card_labels - カード上のすべてのラベルを取得する
add_label_to_card - カードにラベルを追加する
remove_label_from_card - カードからラベルを削除する

チェックリストツール

get_checklist - IDで特定のチェックリストを取得する
create_checklist - カードに新しいチェックリストを作成する
update_checklist - 既存のチェックリストを更新する
delete_checklist - チェックリストを削除する
get_checkitems - チェックリストのすべてのチェック項目を取得する
create_checkitem - チェックリストに新しいチェック項目を作成する
get_checkitem - チェックリスト上の特定のチェック項目を取得する
update_checkitem - チェックリストのチェック項目を更新する
delete_checkitem - チェックリストからチェック項目を削除する
update_checklist_name - チェックリストの名前を更新する
update_checklist_position - カード上のチェックリストの位置を更新する
get_checklist_board - チェックリストがあるボードを取得する
get_checklist_card - チェックリストが載っているカードを取得する
update_checkitem_state_on_card - カード上のチェックアイテムの状態を更新する

構成

サーバーはsrc/config.ts内の集中設定システムを使用します。設定は以下の方法で行うことができます。

環境変数
コマンドライン引数（ --env KEY=VALUEを使用）
コード内のデフォルト値

必要な環境変数:

TRELLO_API_KEY - Trello APIキー
TRELLO_TOKEN - Trello APIトークン

エラー処理

サーバーには包括的なエラー処理が含まれています。

レート制限をサポートするサービスレベルのエラー処理
適切なエラーメッセージによるツールレベルのエラー処理
MCPプロトコルエラー処理
Trello API エラー処理

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

trello-mcp-server