trello-mcp-server

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

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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

APIリファレンスで見つけたすべてのツールを使ってTrelloに接続します

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Server Trello
delorenj
A
security
A
license
A
quality
Facilitates interaction with Trello boards via the Trello API, offering features like rate limiting, type safety, input validation, and error handling for seamless management of cards, lists, and board activities.
Last updated -
9
133
96
JavaScript
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
telegram-mcp
chaindead
-
security
A
license
-
quality
Telegram API integration for accessing user data, managing dialogs (chats, channels, groups), retrieving messages, and handling read status.
Last updated -
161
Go
MIT License
Google Toolbox
jikime
A
security
F
license
A
quality
Google Toolbox
Last updated -
11
8
Python

View all related MCP servers