Asana MCP 服务器

安装

1. 安装依赖：

   • 使用 npm 安装所需的包：

     npm install @cristip73/mcp-server-asana
     

2. 运行 MCP 服务器：

   • 在项目根目录下创建一个 index.js 文件，并添加以下内容：

     const { AsanaMCP } = require('@cristip73/mcp-server-asana');
     const server = new AsanaMCP({
       env: {
         ASANA_ACCESS_TOKEN: 'your-asana-access-token',
         DEFAULT_WORKSPACE_ID: 'your-default-workspace-id'
       }
     });
     server.run();
     

   • 启动服务器：

     node index.js
     

配置

环境变量

在 index.js 文件中，您可以自定义以下环境变量：

const { AsanaMCP } = require('@cristip73/mcp-server-asana');
const server = new AsanaMCP({
  env: {
    ASANA_ACCESS_TOKEN: 'your-asana-access-token', // 必填：您的 Asana 个人访问令牌
    DEFAULT_WORKSPACE_ID: 'your-default-workspace-id', // 可选：默认工作区 ID
    PAGE_SIZE: 50, // 可选：每页显示的项目数量，默认为 50
    DEBUG_MODE: false // 可选：启用调试模式，默认为 false
  }
});
server.run();

示例

以下是一个完整的 MCP 配置示例：

const { AsanaMCP } = require('@cristip73/mcp-server-asana');

// 创建 MCP 实例
const server = new AsanaMCP({
  env: {
    ASANA_ACCESS_TOKEN: 'your-asana-access-token',
    DEFAULT_WORKSPACE_ID: 'your-default-workspace-id'
  }
});

// 定义自定义命令
server.defineCommand('asana.task.create', async (args) => {
  // 在此处实现您的任务创建逻辑
});

// 启动服务器
server.run();

API 接口

以下是 MCP 提供的 Asana 相关接口：

工作区管理

• asana.workspaces.list

  • 获取所有可用的工作区。
  • 返回：工作区列表。

• asana.workspace.select

  • 设置默认工作区。
  • 参数：
    • workspace_id: 要设置为默认的工作区 ID。
  • 返回：确认消息。

项目管理

• asana.projects.list

  • 获取指定工作区的所有项目。
  • 参数：
    • workspace_id: 工作区 ID（可选，默认使用默认工作区）。
  • 返回：项目列表。

• asana.project.create

  • 创建新项目。
  • 参数：
    • project_name: 项目名称。
    • workspace_id: 目标工作区 ID（可选，默认使用默认工作区）。
  • 返回：新建项目的详细信息。

任务管理

• asana.tasks.create

  • 创建新任务。
  • 参数：
    • project_id: 项目 ID。
    • task_name: 任务名称。
    • description: 任务描述（可选）。
  • 返回：新建任务的详细信息。

• asana.task.update

  • 更新现有任务。
  • 参数：
    • task_id: 任务 ID。
    • updates: 更新字段，例如 { status: 'in-progress', due_date: '2023-10-10' }。
  • 返回：更新后的任务详细信息。

团队管理

• asana.teams.list

  • 获取所有团队。
  • 返回：团队列表。

• asana.team.members.get

  • 获取指定团队的成员。
  • 参数：
    • team_id: 团队 ID。
  • 返回：成员列表。

报表与统计

• asana.reports.generate

  • 生成项目报表。
  • 参数：
    • project_id: 项目 ID。
  • 返回：报表数据。

• asana.statistics.get

  • 获取指定工作区的统计数据。
  • 返回：统计信息，包括任务完成率、项目数量等。

提示

任务摘要提示

const { AsanaMCP } = require('@cristip73/mcp-server-asana');

// 创建 MCP 实例并定义命令
const server = new AsanaMCP({
  env: {
    ASANA_ACCESS_TOKEN: 'your-asana-access-token',
    DEFAULT_WORKSPACE_ID: 'your-default-workspace-id'
  }
});

server.defineCommand('asana.task.summary', async (args) => {
  // 在此处实现您的任务摘要逻辑
});

状态更新提示

const { AsanaMCP } = require('@cristip73/mcp-server-asana');

// 创建 MCP 实例并定义命令
const server = new AsanaMCP({
  env: {
    ASANA_ACCESS_TOKEN: 'your-asana-access-token',
    DEFAULT_WORKSPACE_ID: 'your-default-workspace-id'
  }
});

server.defineCommand('asana.status.update', async (args) => {
  // 在此处实现您的状态更新逻辑
});

故障排除

常见问题

• 无法连接到 Asana：

  • 检查您的 ASANA_ACCESS_TOKEN 是否有效。
  • 确保您有正确的权限。

• 工作区未设置：

  • 指定 DEFAULT_WORKSPACE_ID 或在命令中明确指定工作区 ID。

贡献

如何贡献

1. 提交问题和建议到 GitHub 仓库。
2. 创建拉取请求修复问题或添加新功能。

git clone https://github.com/yourusername/mcp-server-asana.git
cd mcp-server-asana
npm install

许可证

项目使用 MIT 许可证，具体内容如下：

MIT License

Copyright (c) 2023 Your Name

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

感谢使用 Asana MCP 服务器！如果有任何问题，请随时联系维护团队。