使用说明
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许可证-有关详细信息,请参阅许可证文件