Tiny Asana MCP Server

🚀 Asana MCP 服务器

Asana MCP 服务器是一个实现 Asana 集成的 Model Context Protocol (MCP) 服务器。它允许 AI 助手通过标准化协议与 Asana 交互，从而高效管理任务、项目和其他 Asana 资源。

🚀 快速开始

本服务器可让 AI 助手借助标准化协议与 Asana 交互，实现任务、项目等资源的管理。启动服务器前，需完成安装和配置。

✨ 主要特性

• 通过 MCP 协议实现 Asana 任务管理。
• 可列出项目和部分（section）。
• 能够获取任务评论。
• 可与 AI 助手无缝集成。

📦 安装指南

你可以使用 npm 全球安装此包：

npm install -g tiny-asana-mcp-server

或直接运行：

npx tiny-asana-mcp-server

📚 详细文档

配置

在使用服务器之前，你需要设置 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 个人访问令牌。

使用方法

启动服务器

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）中的任务。

计划

• [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 文件以获取详细信息。

第三方许可证

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