Trello MCP Server (TypeScript)

Trello MCP サーバー（TypeScript）

Trello との連携を実現する Model Context Protocol（MCP）サーバーの TypeScript 実装です。AI アシスタントが Trello のボード、リスト、カードを操作するためのツールを提供します。

特長

• MCP ツールを通じた Trello API との完全な連携
• パフォーマンス向上のための非同期操作
• TypeScript による型安全な実装
• 包括的なエラー処理
• 環境変数に基づく設定

前提条件

• Node.js 18.x 以上
• npm または yarn
• Trello API の認証情報

インストール

# Install dependencies
make install

設定

ルートディレクトリに、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
  }
}

get_cards

ボードまたは特定のリストにあるカードを取得します。

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

get_card_details

特定のカードの詳細情報を取得します。

{
  "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 認証エラー
• レート制限
• ネットワークの問題
• 無効なリクエストパラメーター

コントリビューション

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

Cline での使用

この MCP サーバーを Cline で使用するには、次の設定を 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 ツールを使用できます。

• get_boards：Trello ボードをすべて一覧表示します
• get_lists：ボードのリストを取得します
• get_cards：ボードまたはリストのカードを取得します
• get_card_details：カードの詳細情報を取得します

ライセンス

ISC ライセンス - 詳細については LICENSE ファイルを参照してください