MCP Server Asana

🚀 Asana MCP 服務器指南

本指南將幫助你瞭解如何安裝、設置和使用 Asana MCP 服務器，它能為你提供 Asana 工作區和項目的相關信息。

🚀 快速開始

📦 安裝指南

使用 npm 安裝

你可以使用 npm 全局安裝 Asana MCP 服務器：

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}