Trello MCP Server

Trello MCP Server

Trello API と連携するためのツールを提供する Model Context Protocol（MCP）サーバーです。

認証情報はプレーンテキストファイルではなく、OS の認証情報マネージャーに安全に保存されます。

機能

• 安全な認証情報の保存：認証情報は OS の認証情報マネージャー（Windows Credential Manager、macOS Keychain、または Linux libsecret）に保存されます
• プレーンテキストのシークレットなし：.env ファイルも、認証情報用の環境変数も使用しません
• Trello との連携：Trello のボード、リスト、カードなどに完全にアクセスできます
• 包括的な API 対応：Trello の主要な操作すべてをサポートします
• 型安全性：Trello オブジェクトの適切な型定義を含む、完全な TypeScript サポート
• エラー処理：コードベース全体で堅牢なエラー管理を実現します

はじめに

前提条件

• Node.js 18 以降
• npm
• Trello API キーとトークン（下記を参照）

Linux のみ：libsecret をインストールします

# Debian/Ubuntu
sudo apt install libsecret-1-dev

# Fedora
sudo dnf install libsecret-devel

# Arch
sudo pacman -S libsecret

インストール

1. このリポジトリをクローンします：

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

2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

4. 認証情報を安全に設定します：

   npm run setup-credentials
   

   Trello API キーとトークンの入力を求められ、入力した認証情報は OS の認証情報マネージャーに保存されます。

   認証情報の取得方法：

   1. https://trello.com/app-key にアクセスします
   2. API キーをコピーします
   3. 「Generate a Token」をクリックして、トークンをコピーします

使い方

MCP サーバーを起動します：

npm start

.env ファイルからの移行

既存の認証情報が .env ファイルにある場合、セットアップスクリプトが自動的に検出します：

npm run setup-credentials

次のように表示されます：

📁 Found existing credentials in: /path/to/.env
   Both API Key and Token found.

Migrate these credentials to secure storage? (Y/n):

移行後、必要に応じて .env ファイルから認証情報を削除できます。

認証情報の管理

• 認証情報の設定／更新：npm run setup-credentials
• 認証情報の削除：npm run delete-credentials

認証情報の保存先：

• Windows：Credential Manager → Windows Credentials → trello-mcp-server
• macOS：Keychain Access → trello-mcp-server
• Linux：GNOME Keyring / KDE Wallet → trello-mcp-server

Claude Desktop の設定

Claude Desktop の設定ファイル（claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["C:/path/to/trello-mcp-server/build/index.js"]
    }
  }
}

利用可能なツール

ボードツール

• 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 - リスト内のすべてのカードを別のリストに移動します

カードツール

• get_card - ID を指定して特定のカードを取得します
• create_card - 新しいカードを作成します
• update_card - 既存のカードを更新します
• delete_card - カードを削除します
• archive_card - カードをアーカイブします
• move_card_to_list - カードを別のリストに移動します
• add_comment - カードにコメントを追加します
• get_comments - カードのコメントを取得します
• add_attachment - カードに添付ファイルを追加します
• get_attachments - カードの添付ファイルを取得します
• set_due_date - カードの期限を設定します
• set_due_complete - カードの期限を完了済みとしてマークします

メンバーツール

• get_me - 認証済みのメンバー（現在のユーザー）を取得します
• get_member - ID またはユーザー名を指定して特定のメンバーを取得します
• get_member_boards - メンバーが参加しているボードを取得します
• get_member_cards - メンバーに割り当てられたカードを取得します
• search_members - 名前でメンバーを検索します

ラベルツール

• get_label - ID で特定のラベルを取得します
• create_label - ボードに新しいラベルを作成します
• update_label - 既存のラベルを更新します
• delete_label - ラベルを削除します
• add_label_to_card - カードにラベルを追加します
• remove_label_from_card - カードからラベルを削除します

チェックリストツール

• get_checklist - ID で特定のチェックリストを取得します
• create_checklist - カードに新しいチェックリストを作成します
• update_checklist - 既存のチェックリストを更新します
• delete_checklist - チェックリストを削除します
• get_checkitems - チェックリスト内のすべてのチェック項目を取得します
• create_checkitem - チェックリストに新しいチェック項目を作成します
• update_checkitem - チェックリスト内のチェック項目を更新します
• delete_checkitem - チェックリストからチェック項目を削除します

セキュリティ

認証情報は OS の認証情報マネージャー（Windows Credential Manager、macOS Keychain、または Linux libsecret）に保存され、ログイン認証情報を使用して暗号化されます。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。