MCP Asana 集成服务器

这是一个基于 Model Context Protocol（模型上下文协议）的服务器，提供用于管理 Asana 任务和项目的工具。该服务器公开了创建、更新、列出和删除 Asana 任务和项目的方法。

特性

• 任务管理

  • 使用名称、描述、截止日期、分配人和所属项目创建新的 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

使用说明

1. 运行服务器

   npm run build && npm start
   

2. 开发模式

   npm run dev
   

3. 简单客户端

   ./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