taskboard-port

taskboard-port

Asana のワークスペース、プロジェクト、タスクを MCP ツールとして提供し、Asana REST API と通信します。taskboard-port は、Asana MCP の機能の中核部分を、新しい名前でクリーンルーム方式により再構築したものです。公開されている Asana API ドキュメントをもとに新たにコードを作成しており、ブランド表記はコピーしていません。元の Asana サーバーはホスト型／リモート型で OAuth を使用しますが、この再構築版は個人アクセストークンを使用して同じ上流 API と通信する REST クライアントであり、ホスト型 OAuth の機能は再現していません。

ツール（中核部分、11 個）

get_current_user、list_workspaces、list_projects、get_project、 create_project、list_tasks、get_task、create_task、 update_task、delete_task、search_tasks。

この機能範囲に含まれないもの：セクション、タグ、ストーリー／コメント、サブタスク、カスタムフィールド、ポートフォリオ／目標、ルール、添付ファイル、チーム／ユーザーの管理、入力補完、イベント／Webhook。

実装上の注記：Asana はリクエスト本文とレスポンスを data エンベロープでラップします。作成／更新の呼び出しでは {data: {...}} を送信し、解析したレスポンスはそのまま返します。list_tasks はルートを決定的に選択し（プロジェクトのタスクエンドポイント、次に担当者クエリ、最後に上限付きリスト）、Asana のリストエンドポイントはこのパラメーターを受け取らないため、completed フィルターはクライアント側で適用します。

セットアップ

export ASANA_ACCESS_TOKEN=...

必要に応じて、ASANA_API_URL で API のベース URL を上書きできます（デフォルトは https://app.asana.com/api/1.0）。トークンが設定されていない場合、すべてのツール呼び出しは不足している変数名を示すエラーで失敗します。

CLI

npx @reneturcios/taskboard-port get_task '{"task_gid":"12345"}'
npx @reneturcios/taskboard-port mcp        # stdio MCP server

各ツール名は、1 つの JSON オブジェクト引数を取るサブコマンドです。

MCP クライアント設定

{
  "mcpServers": {
    "taskboard-port": {
      "command": "npx",
      "args": ["-y", "@reneturcios/taskboard-port", "mcp"],
      "env": { "ASANA_ACCESS_TOKEN": "..." }
    }
  }
}

Docker

docker run -i -e ASANA_ACCESS_TOKEN ghcr.io/cloudcorprecords/taskboard-port

開発

npm install
npm run build
npm test

ライセンス

MIT