Asana MCP 服务器指南

安装和设置

使用 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
  

  这将在变更时自动重新加载，并开启调试模式。

功能概述

提供的命令

1. 获取工作区信息 (GET /api/workspaces)

   • 返回用户拥有的所有工作区及其详细信息。
   • 响应格式：JSON 数组，每个元素包含以下字段：
     • name: 工作区名称（字符串）
     • id: 全局 ID（字符串）
     • type: 资源类型（字符串）
     • is_organization: 是否为组织工作区（布尔值）
     • email_domains: 与工作区关联的电子邮件域列表（字符串数组）

2. 获取项目信息 (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: 项目的自定义字段定义数组

高级功能

资源表示

1. 工作区资源 (asana://workspace/{workspace_gid})

   • 表示 Asana 工作区的资源。
   • 每个工作区作为单独的资源暴露。
   • URI 格式：asana://workspace/{workspace_gid}
   • 返回：包含以下字段的 JSON 对象：
     • name: 工作区名称（字符串）
     • id: 全局 ID（字符串）
     • type: 资源类型（字符串）
     • is_organization: 是否为组织工作区（布尔值）
     • email_domains: 电子邮件域列表（字符串数组）

2. 项目资源 (asana://project/{project_gid})

   • 模板资源，用于通过 GID 获取项目详细信息。
   • URI 格式：`asana://project/{project