MCP Asana

🚀 MCP Asana 集成服務器

這是一個基於 Model Context Protocol（模型上下文協議）的服務器，為管理 Asana 任務和項目提供了強大工具。它公開了創建、更新、列出和刪除 Asana 任務與項目的方法，極大提升了 Asana 任務和項目管理的效率。

🚀 快速開始

本服務器是基於 Model Context Protocol 的強大工具，可高效管理 Asana 任務和項目。以下是快速上手步驟：

1. 安裝依賴：確保滿足先決條件後，克隆倉庫並安裝依賴。
2. 配置環境：複製並修改 .env.example 文件。
3. 啟動服務器：選擇合適的模式啟動服務器。
4. 使用客戶端：通過簡單客戶端執行任務管理操作。

✨ 主要特性

任務管理

• 可使用名稱、描述、截止日期、分配人和所屬項目創建新的 Asana 任務。
• 能列出某個項目中的任務。
• 支持更新現有 Asana 任務，包括名稱、描述、截止日期、分配人、完成狀態。
• 可以刪除 Asana 任務。

項目管理

• 可使用名稱、說明、顏色和可見性設置創建新的 Asana 項目。
• 能列出工作區中的所有項目。
• 支持刪除 Asana 項目。

📦 安裝指南

先決條件

• Node.js 版本 14 或更高。
• 安裝 Asana 開發人員憑據：

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

安裝步驟

git clone [倉庫地址]
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