MCP Server Asana

🚀 Asana MCP サーバーガイド

Asana MCP サーバーは、Asana のワークスペースやプロジェクト情報を取得するためのサーバーです。このガイドでは、サーバーのインストール、設定、使用方法について説明します。

🚀 クイックスタート

📦 インストール

npm を使用したインストール

npm install -g @roychri/mcp-server-asana

リポジトリのクローン（オプション）

コードを変更したい場合やソースコードを確認したい場合は、リポジトリをクローンできます。

git clone https://github.com/roychri/mcp-server-asana.git
cd mcp-server-asana
npm install

コマンドラインオプション

サーバーの起動

npx @roychri/mcp-server-asana [--port PORT]

• --port: サーバーがリッスンするポートを指定します。デフォルトは 3000 です。

開発モードでの実行

npm run dev

これにより、変更があったときに自動的に再読み込みされ、デバッグモードが有効になります。

✨ 主な機能

提供されるコマンド

ワークスペース情報の取得 (GET /api/workspaces)

• ユーザーが所有するすべてのワークスペースとその詳細情報を返します。
• レスポンス形式: JSON 配列で、各要素には以下のフィールドが含まれます。
  • name: ワークスペース名（文字列）
  • id: グローバル ID（文字列）
  • type: リソースタイプ（文字列）
  • is_organization: 組織ワークスペースかどうか（ブール値）
  • email_domains: ワークスペースに関連付けられた電子メールドメインのリスト（文字列配列）

プロジェクト情報の取得 (GET /api/projects)

• ユーザーが所有するすべてのプロジェクトとその詳細情報を返します。
• レスポンス形式: JSON 配列で、各要素には以下のフィールドが含まれます。
  • name: プロジェクト名（文字列）
  • id: グローバル ID（文字列）
  • type: リソースタイプ（文字列）
  • archived: アーカイブされているかどうか（ブール値）
  • public: 公開されているかどうか（ブール値）
  • notes: プロジェクトの説明/メモ（文字列）
  • color: プロジェクトの色（文字列）
  • default_view: デフォルトのビュータイプ（文字列）
  • due_date, due_on, start_on: プロジェクトの日付情報（文字列）
  • workspace: ワークスペースオブジェクト
  • team: チームオブジェクト
  • sections: プロジェクト内のセクション配列
  • custom_fields: プロジェクトのカスタムフィールド定義配列

高度な機能

リソース表現

ワークスペースリソース (asana://workspace/{workspace_gid})

• Asana のワークスペースを表すリソースです。
• 各ワークスペースは個別のリソースとして公開されます。
• URI 形式: asana://workspace/{workspace_gid}
• 返される内容: 以下のフィールドを含む JSON オブジェクト。
  • name: ワークスペース名（文字列）
  • id: グローバル ID（文字列）
  • type: リソースタイプ（文字列）
  • is_organization: 組織ワークスペースかどうか（ブール値）
  • email_domains: 電子メールドメインのリスト（文字列配列）

プロジェクトリソース (asana://project/{project_gid})

• GID を使用してプロジェクトの詳細情報を取得するためのテンプレートリソースです。
• URI 形式: asana://project/{project_gid}