aliyun-yunxiao-projex-mcp

云效 Projex プロジェクト管理 MCP

Alibaba Cloud Yunxiao（阿里云云效）Projex プロジェクト管理用の MCP サーバーです。作業項目、スプリント、コメント、メンバー、プロジェクトのメタデータを MCP ツールとして stdio 経由で提供します。

Alibaba Cloud Yunxiao 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	はい	Yunxiao Bot AccessKey ID
YUNXIAO_USER_ACCESS_KEY_SECRET	はい	Yunxiao Bot AccessKey Secret
YUNXIAO_API_ORG_ID	はい	Yunxiao 組織 ID
YUNXIAO_API_PROJECT_ID	はい	Yunxiao 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）には、選択肢 ID を custom_fields で渡します。
• 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__ という一時的な作業項目を作成し、終了時に削除します。Yunxiao にはイテレーション削除 API がないため、create_sprint のオンライン書き込みテストは行いません。

ライセンス

MIT