Andypost MCP Server Ts Trello

🚀 Trello MCP サーバー（TypeScript）

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

✨ 主な機能

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

📦 インストール

前提条件

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

インストール手順

# 依存関係のインストール
make install

設定

ルートディレクトリに .env ファイルを作成し、Trello の認証情報を追加します。

TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token

利用可能なコマンド

# 依存関係のインストール
make install

# プロジェクトのビルド
make build

# サーバーの起動
make start

# ビルドファイルのクリーンアップ
make clean

# コードチェックツールの実行
make lint

💻 使用例

MCP ツール

get_boards

現在のユーザーのすべての Trello ボードを取得します。

// 入力パラメーターは不要

get_lists

指定されたボードからすべてのリストを取得します。

{
  "request": {
    "board_id": string // ボード ID
  }
}

get_cards

指定されたボードまたは特定のリストからカードを取得します。

{
  "request": {
    "board_id": string,    // ボード ID
    "list_id"?: string     // オプション：特定のリストの ID
  }
}

get_card_details

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

{
  "request": {
    "card_id": string      // カード ID
  }
}

📚 ドキュメント

開発

このプロジェクトは TypeScript を使用して型安全を実現し、開発者に良好なエクスペリエンスを提供します。ソースコードは以下のように構成されています。

• src/index.ts - サーバーのメインエントリポイント
• src/trello-client.ts - Trello API クライアントの実装
• src/types.ts - TypeScript の型定義

ビルド

このプロジェクトは TypeScript コンパイラを使用してビルドされます。

# プロジェクトのビルド
make build

# 出力ファイルは build/ ディレクトリに配置されます

エラー処理

サーバーは包括的なエラー処理を実装しており、以下のエラーを扱います。

• API 認証エラー
• レート制限
• ネットワーク問題
• 無効なリクエストパラメーター

貢献ガイド

1. このリポジトリを Fork します。
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）。
3. 変更をコミットします（git commit -m 'Add some amazing feature'）。
4. ブランチにプッシュします（git push origin feature/amazing-feature）。
5. Pull Request を作成します。

Cline との連携

この MCP サーバーを Cline と一緒に使用するには、以下の設定を Cline MCP 設定ファイル（~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json）に追加します。

{
  "mcp_servers": {
    "trello_server": {
      "url": "http://localhost:3000",
      "type": "trello"
    }
  },
  "default_mcp_server": "trello_server"
}

📄 ライセンス

このプロジェクトは ISC ライセンスの下で提供されています。詳細については、LICENSE ファイルを参照してください。