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