aliyun-yunxiao-projex-mcp

Name: aliyun-yunxiao-projex-mcp
Author: MrLinWang

本地服务

github.com生产力01 天前更新

代码仓库访问官网

关于 aliyun-yunxiao-projex-mcp

面向阿里云云效 Projex 项目的 MCP 服务，通过 Bot Key 操作指定项目的工作项、迭代、评论、成员和项目元数据。支持读取、创建、更新及受确认保护的删除操作。

主要功能

01读取项目与成员信息
02查询工作项及字段配置
03管理工作项和评论
04创建与查询迭代
05删除操作需确认

适用场景

01查询项目工作项与状态
02创建或更新工作项
03查看迭代和项目评论

MCP 相关

通过 stdio 向 MCP 客户端提供云效 Projex 项目管理工具。使用 Bot Key，所有操作限定在配置的项目内。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "mrlinwang-aliyun-yunxiao-projex": {
      "command": "uvx",
      "args": [
        "yunxiao-projex-mcp"
      ],
      "env": {
        "YUNXIAO_USER_ACCESS_KEY_ID": "<YUNXIAO_USER_ACCESS_KEY_ID>",
        "YUNXIAO_USER_ACCESS_KEY_SECRET": "<YUNXIAO_USER_ACCESS_KEY_SECRET>",
        "YUNXIAO_USER_NAME": "<YUNXIAO_USER_NAME>",
        "YUNXIAO_API_ORG_ID": "<YUNXIAO_API_ORG_ID>",
        "YUNXIAO_API_PROJECT_ID": "<YUNXIAO_API_PROJECT_ID>",
        "YUNXIAO_API_ENDPOINT": "<YUNXIAO_API_ENDPOINT>"
      }
    }
  }
}

启动命令uvx yunxiao-projex-mcp

需要配置的环境变量

YUNXIAO_USER_ACCESS_KEY_ID密钥Yunxiao Bot AccessKey ID

YUNXIAO_USER_ACCESS_KEY_SECRET密钥Yunxiao Bot AccessKey Secret

YUNXIAO_USER_NAMEYunxiao user display name for self-assignee detection; optional, must match the AccessKey user when set

YUNXIAO_API_ORG_IDYunxiao organization ID

YUNXIAO_API_PROJECT_IDYunxiao Projex project ID

YUNXIAO_API_ENDPOINTYunxiao API endpoint; defaults to devops.cn-hangzhou.aliyuncs.com

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

安装包

pypiyunxiao-projex-mcp0.1.3stdio

工具

收录的工具列表 · 更新于 5 天前

此工具无需参数。

详细介绍

来自项目 README

云效 Projex 项目管理 MCP

An MCP server for Alibaba Cloud Yunxiao (阿里云云效) Projex project management. It exposes work items, sprints, comments, members and project metadata as MCP tools over stdio.

基于阿里云云效 Projex OpenAPI 的 MCP 服务。使用 YUNXIAO_USER_* Bot Key，所有工具固定作用于 YUNXIAO_API_PROJECT_ID 指定的项目，无法访问其他项目。

安装

从 PyPI 运行，无需本地克隆：

uvx yunxiao-projex-mcp

或安装到本地环境：

uv tool install yunxiao-projex-mcp

本地开发：

uv sync --all-extras

配置

需要以下环境变量：

变量	必填	说明
`YUNXIAO_USER_ACCESS_KEY_ID`	是	云效 Bot AccessKey ID
`YUNXIAO_USER_ACCESS_KEY_SECRET`	是	云效 Bot AccessKey Secret
`YUNXIAO_API_ORG_ID`	是	云效组织 ID
`YUNXIAO_API_PROJECT_ID`	是	云效 Projex 项目 ID
`YUNXIAO_API_ENDPOINT`	否	默认 `devops.cn-hangzhou.aliyuncs.com`

标准 mcpServers 配置（Magpie / Claude Desktop / Cursor 等通用）：

{
  "mcpServers": {
    "yunxiao-projex": {
      "command": "uvx",
      "args": ["yunxiao-projex-mcp"],
      "env": {
        "YUNXIAO_USER_ACCESS_KEY_ID": "your-access-key-id",
        "YUNXIAO_USER_ACCESS_KEY_SECRET": "your-access-key-secret",
        "YUNXIAO_API_ORG_ID": "your-organization-id",
        "YUNXIAO_API_PROJECT_ID": "your-project-id",
        "YUNXIAO_API_ENDPOINT": "devops.cn-hangzhou.aliyuncs.com"
      }
    }
  }
}

YUNXIAO_API_ENDPOINT 可省略，省略时使用默认值。

本地 `.env`

从源码运行时，可在项目根目录放置 .env：

YUNXIAO_API_ORG_ID=...
YUNXIAO_API_PROJECT_ID=...
YUNXIAO_API_ENDPOINT=devops.cn-hangzhou.aliyuncs.com
YUNXIAO_USER_ACCESS_KEY_ID=...
YUNXIAO_USER_ACCESS_KEY_SECRET=...

建议执行 chmod 600 .env，并确保 .env 不被提交到版本库。

接入 Codex

codex mcp add yunxiao_projex \
  --env YUNXIAO_API_ORG_ID=... \
  --env YUNXIAO_API_PROJECT_ID=... \
  --env YUNXIAO_USER_ACCESS_KEY_ID=... \
  --env YUNXIAO_USER_ACCESS_KEY_SECRET=... \
  -- uvx yunxiao-projex-mcp
codex mcp list

等价的 ~/.codex/config.toml 配置：

[mcp_servers.yunxiao_projex]
command = "uvx"
args = ["yunxiao-projex-mcp"]

[mcp_servers.yunxiao_projex.env]
YUNXIAO_API_ORG_ID = "..."
YUNXIAO_API_PROJECT_ID = "..."
YUNXIAO_USER_ACCESS_KEY_ID = "..."
YUNXIAO_USER_ACCESS_KEY_SECRET = "..."

接入 Magpie

该服务发布到官方 MCP Registry 后，名称为 io.github.MrLinWang/aliyun-yunxiao-projex-mcp。在 Magpie 的 Discover 中搜索 yunxiao、projex、aliyun 或 mcp 即可找到，安装时按提示填写环境变量。

也可以直接编辑 Magpie 的 MCP 配置，使用上面的 mcpServers JSON 片段。

工具

只读：get_project、list_project_members、list_workitem_types、list_workitem_fields、list_workitem_statuses、list_workitems、get_workitem、list_workitem_comments、list_sprints、get_sprint。

写入：create_workitem、update_workitem、create_workitem_comment、update_workitem_comment、create_sprint。

删除：delete_workitem、delete_workitem_comment，均要求 confirm=true。

使用约定

assigned_to、owner_ids、participants、trackers、verifier 使用项目成员的账号 ID，可通过 list_project_members 获取。
创建工作项前先查 list_workitem_types、list_workitem_fields 和 list_workitem_statuses；必填自定义字段（例如 priority）通过 custom_fields 传入选项 ID。
list_project_members 内部固定使用 targetType=Space。
描述和评论默认使用 Markdown；日期使用 YYYY-MM-DD。
删除评论和删除工作项会先校验资源属于当前项目，再执行删除；工作项删除为异步生效，列表索引可能需要数秒刷新。
create_workitem_comment 默认创建顶级评论，回复评论时才需要传 parent_id。

权限限制

当前 Bot 角色为“开发机器人”，修改项目字段、管理项目成员会返回 403。
不包含工时/预估、附件、工作项关联、工作项动态、项目创建/删除、迭代修改/删除。
代码库与流水线不在本服务范围内。

测试

.venv/bin/python -m pytest -m "not live"
YUNXIAO_LIVE_TESTS=1 .venv/bin/python -m pytest -m "live and not live_write"
YUNXIAO_LIVE_TESTS=1 YUNXIAO_LIVE_WRITE_TESTS=1 .venv/bin/python -m pytest -m live_write

写入测试会创建 __mcp_probe__ 临时工作项并在结束时删除；create_sprint 不做线上写入测试，因为云效未提供删除迭代接口。