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ファイルを参照してください。

Install Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

Need Help?

Report Issue

Reddit Discussion

Related Servers

Tools

View all tools

trello-mcp-server