Tiny Asana MCP Server

🚀 Asana MCP 服务器

Asana MCP 服务器是一个实现 Asana 集成的 Model Context Protocol (MCP) 服务器。它允许 AI 助手通过标准化协议与 Asana 交互，进而管理任务、项目和其他 Asana 资源，为工作流的自动化和智能化提供了有力支持。

🚀 快速开始

在使用 Asana MCP 服务器前，你需要先进行安装和配置。安装完成并配置好 Asana 凭据后，即可启动服务器，让 AI 助手与你的 Asana 工作区进行交互。

✨ 主要特性

• 通过 MCP 协议实现 Asana 任务管理，使任务管理更加高效和标准化。
• 能够列出项目和部分（section），方便了解项目的整体结构。
• 可以获取任务评论，便于团队成员之间的沟通和协作。
• 可与 AI 助手无缝集成，提升工作的自动化程度。

📦 安装指南

你可以使用以下两种方式安装此包：

• 使用 npm 全球安装：

npm install -g tiny-asana-mcp-server

• 直接运行：

npx tiny-asana-mcp-server

💻 使用示例

基础用法

启动服务器

env ASANA_TOKEN=... npx -y tiny-asana-mcp-server

服务器启动后将连接到 MCP 客户端，允许 AI 助手与你的 Asana 工作区交互。

可用工具

服务器提供以下 MCP 工具：

• asana_get_projects：列出所有可访问的项目。
• asana_get_sections_by_project：列出项目中的部分（section）。
• asana_get_task_stories：获取任务上的评论。
• asana_get_task：检索特定任务的详细信息。
• asana_get_tasks_by_project：列出项目中的任务。
• asana_get_tasks_by_section：列出部分（section）中的任务。

📚 详细文档

配置

在使用服务器之前，你需要设置 Asana 凭据。可通过以下两种方式进行配置：

• 创建项目根目录中的 .env 文件，内容如下：

ASANA_TOKEN=your_asana_personal_access_token

• 通过命令行提供环境变量：

env ASANA_TOKEN=your_asana_personal_access_token npx -y tiny-asana-mcp-server

你可以在 Asana 开发者控制台 获取 Asana 个人访问令牌。

计划

• [x] 创建 MVP 以提供 Asana 集成。
• [ ] 添加基于环境的工具配置（通过环境变量启用/禁用特定工具）。
• [ ] 覆盖所有现有端点。

开发

要设置开发环境，可按以下步骤操作：

1. 克隆仓库：

git clone git@github.com:bnwebdev/tiny-asana-mcp-server.git
cd tiny-asana-mcp-server

2. 安装依赖项：

yarn install

3. 以开发模式启动：

yarn dev

贡献

欢迎贡献！请随意提交 Pull Request。

📄 许可证

此项目遵循 MIT License，查看 LICENSE 文件以获取详细信息。

第三方许可证

本软件使用了 Asana Node.js 客户端库，该库遵循 Apache License, Version 2.0。