Trello MCP サーバー (TypeScript)

Trello 統合用の Model Context Protocol (MCP) サーバーの TypeScript 実装。AI アシスタントが Trello ボード、リスト、カードと対話するためのツールを提供します。

特徴

• MCPツールによるTrello APIの完全統合

• パフォーマンス向上のための非同期操作

• TypeScriptを使用した型安全な実装

• 包括的なエラー処理

• 環境ベースの構成

Related MCP server: Claude MCP Trello

前提条件

• 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ツール

ボードを取得する

認証されたユーザーのすべての 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
  }
}

カードの詳細を取得する

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

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