UiPath MCP服务器

一个将UiPath Orchestrator Cloud API暴露给MCP兼容客户端的模型上下文协议服务器,支持OAuth2认证和多种Orchestrator工具操作。

  • by LokiMCPUniverse
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 LokiMCPUniverse/uipath-mcp-server

使用说明

UiPath MCP服务器

Uipath Mcp服务器

公开UiPath编排器的模型上下文协议(MCP)服务器 云API到兼容MCP的客户端,如Claude Desktop。建立在 官方的 mcp 异步Python SDK(FastMCP) httpx OAuth2客户端 凭证身份验证。

特性

  • OAuth2客户端凭据流向UiPath云身份服务器 自动令牌缓存和刷新。
  • 通过个人访问令牌(PAT)支持 UIPATH_ACCESS_TOKEN 有人是。
  • 可选的Orchestrator文件夹范围 X-UIPATH-OrganizationUnitId.
  • 类型化工具表面覆盖流程、机器人、机器、作业、队列和 资产。
  • 在401上重试一次,并强制刷新令牌。

安装

从源代码安装:

git clone https://github.com/LokiMCPUniverse/uipath-mcp-server.git
cd uipath-mcp-server
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

配置

所有配置都是从环境变量中读取的(前缀为 UIPATH_) 或可选 .env 工作目录中的文件。

变量 必填 描述
UIPATH_ORCHESTRATOR_URL no 基本URL,默认为 https://cloud.uipath.com.
UIPATH_ORGANIZATION_NAME yes 组织(帐户)逻辑名称。
UIPATH_TENANT_NAME yes 租户逻辑名称。
UIPATH_CLIENT_ID yes* 外部应用程序的OAuth2客户端id。
UIPATH_CLIENT_SECRET 是* OAuth2客户端机密。
UIPATH_ACCESS_TOKEN 否 预先颁发的访问令牌或PAT(覆盖客户端凭据)。
UIPATH_FOLDER_ID 否 通过发送的文件夹id X-UIPATH-OrganizationUnitId.
UIPATH_TIMEOUT no HTTP超时时间(秒)(默认值30)。

* 如果满足以下条件,则不需要 UIPATH_ACCESS_TOKEN 提供。

跑步

uipath-mcp

Claude桌面配置

将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "uipath": {
      "command": "uipath-mcp",
      "env": {
        "UIPATH_ORGANIZATION_NAME": "your-org",
        "UIPATH_TENANT_NAME": "your-tenant",
        "UIPATH_CLIENT_ID": "...",
        "UIPATH_CLIENT_SECRET": "...",
        "UIPATH_FOLDER_ID": "123456"
      }
    }
  }
}

工具

工具 说明
list_processes 列出编排器流程(发布)。
list_robots 列出在租户中注册的机器人。
list_machines 列出在租户中注册的机器。
start_job 启动一个进程,可以选择使用特定的机器人和输入参数。
list_jobs 列出作业,可选择按州筛选。
get_job 按id获取单个工作
stop_job 停止或终止正在运行的作业(SoftStop 或 Kill).
list_queue_items 列出队列项,可选择按队列名称和状态进行筛选。
add_queue_item 将具有任意特定内容的新项目添加到队列中。
list_assets 列出当前文件夹中的资产。

发展

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest -x --tb=short
ruff check src tests

许可证

MIT许可证-有关详细信息,请参阅许可证文件