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}