asanamcp (Adlio)

asanamcp

    

Asana API的MCP服务器。

快速开始

1. 获取Asana个人访问令牌https://app.asana.com/0/my-apps

1. 安装：

# Homebrew
brew install adlio/tap/asanamcp

# From crates.io
cargo install asanamcp

# From GitHub
cargo install --git https://github.com/adlio/asanamcp

1. 添加到Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "asana": {
      "command": "asanamcp",
      "env": {
        "ASANA_TOKEN": "your-personal-access-token",
        "ASANA_DEFAULT_WORKSPACE": "your-workspace-gid"
      }
    }
  }
}

这 ASANA_DEFAULT_WORKSPACE 是可选的，但如果您主要在一个工作区工作，建议使用。设置后，基于工作区的操作（搜索、列出项目、列出用户等）将使用此默认值，从而减少在每个请求中指定工作区GID的需要。

测试服务器

# Dump tool schemas (useful for debugging)
asanamcp --schema

# Dump a specific tool's schema
asanamcp --schema get

# Launch the MCP Inspector (interactive web UI)
make inspect

工具

asana_get

使用递归遍历支持获取任何Asana资源。

{"resource_type": "portfolio", "gid": "123", "depth": -1}

\*用途 ASANA_DEFAULT_WORKSPACE 如果gid为空。

深度： -1 =无限制， 0 =无， N =N个级别。

asan_create

{"resource_type": "task", "project_gid": "123", "name": "New task", "assignee": "me"}

\*用途 ASANA_DEFAULT_WORKSPACE 如果没有提供。

体式更新

{"resource_type": "task", "gid": "123", "completed": true}

支持： task, project, portfolio, section, tag, comment, status_update, project_brief （“概述”选项卡上的“关键资源”，而不是“注释”选项卡上）。

asana_delete

永久删除Asana资源。此操作是 不可逆的.

{"resource_type": "task", "gid": "123"}

支持： task, project, portfolio, section, tag, comment, status_update, project_brief.

asan_link

{"action": "add", "relationship": "task_project", "target_gid": "task123", "item_gid": "proj456"}

使用 item_gid 对于单个项目或 item_gids 用于批量操作。

体式任务搜索

搜索具有丰富过滤选项的任务。

{"workspace_gid": "123", "text": "bug", "completed": false, "assignee": "me"}

体式资源搜索

使用typeahead按名称搜索任何Asana资源。使用此功能查找项目、模板、用户、团队等。

{"query": "CloudSmith", "resource_type": "project_template"}

图书馆使用情况

use asanamcp::{AsanaClient, Resource};

#[tokio::main]
async fn main() -> Result {
    let client = AsanaClient::from_env()?;

    let workspaces: Vec = client
        .get_all("/workspaces", &[("opt_fields", "gid,name")])
        .await?;

    for ws in workspaces {
        println!("{}: {:?}", ws.gid, ws.fields.get("name"));
    }
    Ok(())
}

发展

make ci         # Run all checks (fmt, lint, build, docs, test)
make test       # Run tests
make coverage   # Coverage report
make fmt        # Format code
make lint       # Run clippy
make inspect    # Open MCP Inspector web UI
make schema     # Dump tool schemas to stdout

许可证

麻省理工学院