mcpField
T
taskboard-port

taskboard-port

本地服务
github.com/CloudCorpRecords生产力02 周前更新
代码仓库

关于 taskboard-port

taskboard-port 是 REST 客户端，将 Asana 工作区、项目和任务的一组核心操作作为 MCP 工具提供。它使用个人访问令牌，不复现托管服务的 OAuth 界面。

主要功能

  1. 0111 个 Asana MCP 工具
  2. 02工作区与项目操作
  3. 03创建、读取、更新和删除任务
  4. 04搜索任务
  5. 05使用个人访问令牌认证

适用场景

  1. 01列出工作区和项目
  2. 02创建或更新 Asana 任务
  3. 03搜索任务或获取任务详情

MCP 相关

stdio MCP 服务提供 11 个工具，用于操作 Asana 用户、工作区、项目和任务。它使用 `ASANA_ACCESS_TOKEN` 连接 Asana REST API。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cloudcorprecords-taskboard-port": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/taskboard-port"
      ]
    }
  }
}
启动命令npx -y @reneturcios/taskboard-port

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@reneturcios/taskboard-port0.1.0
ocighcr.io/cloudcorprecords/taskboard-port:0.1.0

工具

11

收录的工具列表 · 更新于 1 周前

此工具无需参数。

详细介绍

taskboard-port

将 Asana 工作区、项目和任务作为 MCP 工具，通过 Asana REST API 进行交互。taskboard-port 是对 Asana MCP 核心功能子集的 全新独立重建，使用了新名称：根据公开的 Asana API 文档编写全新代码， 未复制品牌内容。原版 Asana 服务是托管的远程服务，使用 OAuth；此重建版是 使用个人访问令牌调用同一上游 API 的 REST 客户端，不会复现托管版的 OAuth 功能。

工具（核心子集，共 11 个）

get_current_user、list_workspaces、list_projects、get_project、 create_project、list_tasks、get_task、create_task、 update_task、delete_task、search_tasks。

此子集不包含：分区、标签、动态消息/评论、子任务、自定义字段、项目组合/目标、规则、附件、团队/用户管理、 类型提示、事件/网络钩子。

实现说明：Asana 会将请求正文和响应封装在 data 信封中——创建/更新调用会发送 {data: {...}}，解析后的 响应则原样返回。list_tasks 会确定性地选择路由 （项目任务端点、否则使用受分配人查询、再否则使用限制数量的列表），并在客户端应用 completed 筛选条件，因为 Asana 的列表端点不接受此类参数。

设置

export ASANA_ACCESS_TOKEN=...

也可以通过 ASANA_API_URL 覆盖 API 基础 URL （默认为 https://app.asana.com/api/1.0）。如果未提供令牌，每次工具调用都会失败，并指出缺少的变量。

CLI

npx @reneturcios/taskboard-port get_task '{"task_gid":"12345"}'
npx @reneturcios/taskboard-port mcp        # stdio MCP server

每个工具名称都是一个子命令，接受一个 JSON 对象参数。

MCP 客户端配置

{
  "mcpServers": {
    "taskboard-port": {
      "command": "npx",
      "args": ["-y", "@reneturcios/taskboard-port", "mcp"],
      "env": { "ASANA_ACCESS_TOKEN": "..." }
    }
  }
}

Docker

docker run -i -e ASANA_ACCESS_TOKEN ghcr.io/cloudcorprecords/taskboard-port

开发

npm install
npm run build
npm test

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。