MCP Asana

🚀 MCP Asana 集成サーバー

このサーバーは、Model Context Protocol（モデルコンテキストプロトコル）に基づいて構築されており、Asana のタスクとプロジェクトを管理するためのツールを提供します。このサーバーは、Asana のタスクとプロジェクトの作成、更新、一覧表示、削除を行うメソッドを公開しています。

✨ 主な機能

タスク管理

• 名前、説明、期限、担当者、所属プロジェクトを指定して、新しい Asana タスクを作成します。
• 特定のプロジェクト内のタスクを一覧表示します。
• 既存の Asana タスクの情報（名前、説明、期限、担当者、完了状態）を更新します。
• Asana タスクを削除します。

プロジェクト管理

• 名前、説明、色、可視性設定を指定して、新しい Asana プロジェクトを作成します。
• ワークスペース内のすべてのプロジェクトを一覧表示します。
• Asana プロジェクトを削除します。

📦 インストール

前提条件

• Node.js バージョン 14 以上
• Asana 開発者の認証情報をインストールします。

  cp .env.example .env && edit .env
  

インストール手順

git clone [リポジトリのURL]
cd mcp-asana
npm install

設定

.env.example ファイルをコピーし、以下の内容に変更します。

ASANA_ACCESS_TOKEN=your_asana_access_token
ASANA_PROJECT_ID=your_asana_project_id
ASANA_WORKSPACE_ID=your_asana_workspace_id

💻 使用例

サーバーの起動

npm run build && npm start

開発モード

npm run dev

シンプルなクライアント

./simple-client.sh [コマンド]

• ./simple-client.sh create-task：タスクを作成します。
• ./simple-client.sh list-tasks：すべてのタスクを一覧表示します。
• ./simple-client.sh update-task：タスクを更新します。
• ./simple-client.sh delete-task：タスクを削除します。

📚 ドキュメント

プロジェクト構造

mcp-asana/
├── asana/              # Asana API 統合
│   ├── config.js       # 設定と共通ユーティリティ
│   ├── index.js        # メインエントリポイント
│   ├── index.d.ts      # TypeScript 宣言ファイル
│   ├── projects.js     # プロジェクト管理機能
│   └── tasks.js        # タスク管理機能
├── src/
│   ├── server.ts       # MCP サーバーの実装
│   └── simple-client.ts # コマンドラインクライアント
├── dist/               # コンパイルされた JavaScript ファイル
├── simple-client.sh    # Shell スクリプト
├── listWorkspaces.js   # すべてのワークスペースを一覧表示するツール
├── listAllProjects.js  # すべてのプロジェクトを一覧表示するツール
├── .env.example        # サンプル環境ファイル
└── package.json        # プロジェクトの依存関係

既知の制限

• 現在、HTTP/SSE トランスポートはサポートされていません。
• API レスポンスのエラー処理は限られています。
• タスクまたはプロジェクトの一覧表示におけるページング機能はありません。

📄 ライセンス

MIT