Skip to content
MCP server

Aliyun Yunxiao Projex MCP

Stdio MCP server for Alibaba Cloud Yunxiao Projex work items, sprints and comments

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.3
Listing updated
today

Similar MCP servers

About Aliyun Yunxiao Projex MCP

Aliyun Yunxiao Projex MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

This Python server wraps the Yunxiao Projex OpenAPI and is pinned to a single project, set by an environment variable, so its tools cannot reach any other project. It signs in with a Yunxiao bot AccessKey, runs over stdio and is started with uvx from PyPI.

Work items can be listed, read, created, updated and deleted; comments and sprints are covered too. The server can work out which work items belong to the AccessKey's own user, and its isMine flag appears on list and get results. It also downloads attached files and images with the bot's credentials, returning images inline and other files as base64 up to 10 MiB, or saving them to disk.

The README is in Chinese and English. It notes limits: the bot role cannot edit project fields or members, and time estimates, attachment uploads, work item links, code repositories and pipelines are out of scope. Deletes require confirm=true. An agent skill in the repository adds status-sync conventions.

Install

Run in a terminal

claude mcp add aliyun-yunxiao-projex-mcp --env YUNXIAO_USER_ACCESS_KEY_ID='<YUNXIAO_USER_ACCESS_KEY_ID>' --env YUNXIAO_USER_ACCESS_KEY_SECRET='<YUNXIAO_USER_ACCESS_KEY_SECRET>' --env YUNXIAO_API_ORG_ID='<YUNXIAO_API_ORG_ID>' --env YUNXIAO_API_PROJECT_ID='<YUNXIAO_API_PROJECT_ID>' -- uvx yunxiao-projex-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "aliyun-yunxiao-projex-mcp": {
      "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_API_ORG_ID": "<YUNXIAO_API_ORG_ID>",
        "YUNXIAO_API_PROJECT_ID": "<YUNXIAO_API_PROJECT_ID>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "aliyun-yunxiao-projex-mcp": {
      "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_API_ORG_ID": "<YUNXIAO_API_ORG_ID>",
        "YUNXIAO_API_PROJECT_ID": "<YUNXIAO_API_PROJECT_ID>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "aliyun-yunxiao-projex-mcp": {
      "type": "stdio",
      "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_API_ORG_ID": "<YUNXIAO_API_ORG_ID>",
        "YUNXIAO_API_PROJECT_ID": "<YUNXIAO_API_PROJECT_ID>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "aliyun-yunxiao-projex-mcp": {
      "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_API_ORG_ID": "<YUNXIAO_API_ORG_ID>",
        "YUNXIAO_API_PROJECT_ID": "<YUNXIAO_API_PROJECT_ID>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "aliyun-yunxiao-projex-mcp": {
      "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_API_ORG_ID": "<YUNXIAO_API_ORG_ID>",
        "YUNXIAO_API_PROJECT_ID": "<YUNXIAO_API_PROJECT_ID>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • YUNXIAO_USER_ACCESS_KEY_IDYunxiao Bot AccessKey IDRequired
  • YUNXIAO_USER_ACCESS_KEY_SECRETYunxiao Bot AccessKey SecretRequired
  • YUNXIAO_USER_NAMEYunxiao user display name for self-assignee detection; optional, must match the AccessKey user when set
  • YUNXIAO_API_ORG_IDYunxiao organization IDRequired
  • YUNXIAO_API_PROJECT_IDYunxiao Projex project IDRequired
  • YUNXIAO_API_ENDPOINTYunxiao API endpoint; defaults to devops.cn-hangzhou.aliyuncs.com

Tools this server provides (19)

Taken from the project documentation; the running server may differ.

get_project
Read-only Yunxiao Projex tool.
get_current_user
Read-only Yunxiao Projex tool.
list_project_members
Read-only Yunxiao Projex tool.
list_workitem_types
Read-only Yunxiao Projex tool.
list_workitem_fields
Read-only Yunxiao Projex tool.
list_workitem_statuses
Read-only Yunxiao Projex tool.
list_workitems
Read-only Yunxiao Projex tool.
get_workitem
Read-only Yunxiao Projex tool.
get_workitem_file
Read-only Yunxiao Projex tool.
list_workitem_comments
Read-only Yunxiao Projex tool.
list_sprints
Read-only Yunxiao Projex tool.
get_sprint
Read-only Yunxiao Projex tool.
create_workitem
Write tool for Yunxiao Projex.
update_workitem
Write tool for Yunxiao Projex.
create_workitem_comment
Write tool for Yunxiao Projex.
update_workitem_comment
Write tool for Yunxiao Projex.
create_sprint
Write tool for Yunxiao Projex.
delete_workitem
Delete tool; requires confirm=true.
delete_workitem_comment
Delete tool; requires confirm=true.

What it does

Project-scoped tools
Every tool acts only on the project ID you configure.
Work item CRUD
List, read, create, update and delete work items.
Self-assignee detection
Finds items assigned to the AccessKey user via assigned_to_me and isMine.
Authenticated downloads
Fetches work item attachments and images, with optional save-to-disk.
Comments and sprints
Create comments and sprints, and read members and statuses.
Guarded deletes
Deleting items and comments requires confirm=true.

Good for

  • Have an agent triage the sprint backlog in Yunxiao
  • Create a work item with required custom fields
  • Post a pull request link as a comment on the linked work item
  • Download an attached screenshot from a work item
  • List only the work items assigned to the bot

Pricing

Open source

MIT licensed; requires a Yunxiao account and bot AccessKey

Aliyun Yunxiao Projex MCP FAQ

How do I run it?

Run uvx yunxiao-projex-mcp, with the organisation ID, project ID and bot AccessKey set as environment variables.

Can it touch other projects?

No. All tools are fixed to the configured project.

What is it not able to do?

It has no time tracking, attachment upload, work item links, project creation, code repositories or pipelines.

What is the licence?

MIT.

Is Aliyun Yunxiao Projex MCP free?

Yes. Aliyun Yunxiao Projex MCP is open source, so you can use and self-host it for free.

How do I add Aliyun Yunxiao Projex MCP to Claude Code?

Run this command in your terminal: claude mcp add aliyun-yunxiao-projex-mcp --env YUNXIAO_USER_ACCESS_KEY_ID='<YUNXIAO_USER_ACCESS_KEY_ID>' --env YUNXIAO_USER_ACCESS_KEY_SECRET='<YUNXIAO_USER_ACCESS_KEY_SECRET>' --env YUNXIAO_API_ORG_ID='<YUNXIAO_API_ORG_ID>' --env YUNXIAO_API_PROJECT_ID='<YUNXIAO_API_PROJECT_ID>' -- uvx yunxiao-projex-mcp

What are the best alternatives to Aliyun Yunxiao Projex MCP?

The closest alternatives to Aliyun Yunxiao Projex MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers