Citrix监视器MCP
用于查询Citrix Monitor Service OData API的MCP（模型上下文协议）服务器。支持Citrix Cloud（DaaS）和本地CVAD部署。
特性
- 双重部署支持：与Citrix Cloud和本地CVAD配合使用
- 综合监控：机器、会话、连接、应用程序、用户
- 分析：自定义OData查询、聚合、失败摘要
- 费率限制处理：429个响应的回退自动重试
- 分页：自动处理分页响应
安装
pip install -e .或者使用紫外线：
uv pip install -e .配置
复制 .env.example 到 .env 并配置：
思杰云（DaaS）
CITRIX_DEPLOYMENT=cloud
CITRIX_CUSTOMER_ID=your-customer-id
CITRIX_CLIENT_ID=your-client-id
CITRIX_CLIENT_SECRET=your-client-secret
CITRIX_REGION=us # us, eu, ap-s, jp内部（CVAD）
CITRIX_DEPLOYMENT=onprem
CITRIX_DDC_HOST=https://ddc.example.com
CITRIX_DOMAIN=YOURDOMAIN
CITRIX_USERNAME=admin
CITRIX_PASSWORD=your-password使用Claude代码
添加到您的Claude Code MCP配置中：
{
"mcpServers": {
"citrix-monitor": {
"command": "citrix-monitor-mcp",
"env": {
"CITRIX_DEPLOYMENT": "cloud",
"CITRIX_CUSTOMER_ID": "your-customer-id",
"CITRIX_CLIENT_ID": "your-client-id",
"CITRIX_CLIENT_SECRET": "your-client-secret",
"CITRIX_REGION": "us"
}
}
}
}可用工具
机器
| 工具 | 说明 |
|---|---|
citrix_machine_list | 列出所有配备可选过滤器的机器 |
citrix_machine_status | 获取特定机器的详细信息 |
citrix_machine_metrics | CPU/内存使用指标 |
citrix_machine_failures | 机器故障日志 |
会话
| 工具 | 说明 |
|---|---|
citrix_session_list | 列出会话（活动/所有） |
citrix_session_details | 按键获取会话 |
citrix_session_logon_metrics | 登录时间细分 |
citrix_session_count | 统计会话数 |
连接
| 工具 | 说明 |
|---|---|
citrix_connection_list | 列出连接 |
citrix_connection_failures | 连接失败日志 |
citrix_failure_summary | 按时间段统计的失败次数 |
应用程序
| 工具 | 说明 |
|---|---|
citrix_app_list | 列出已发布的应用程序 |
citrix_app_instances | 正在运行应用程序实例 |
citrix_app_errors | 应用程序错误/故障 |
用户
| 工具 | 说明 |
|---|---|
citrix_user_list | 列出用户 |
citrix_user_details | 获取用户详细信息 |
citrix_user_sessions | 用户会话历史记录 |
分析
| 工具 | 说明 |
|---|---|
citrix_query_raw | 执行自定义OData查询 |
citrix_delivery_groups | 列出交付组 |
citrix_hypervisors | 列出管理程序 |
citrix_load_index | 机器负载数据 |
citrix_entity_count | 统计实体 |
citrix_aggregate | OData聚合 |
查询示例
列出所有已注册的机器
citrix_machine_list(registration_state="Registered")为用户获取活动会话
citrix_session_list(user_name="DOMAIN\\jsmith", active_only=true)查找过去24小时内的连接故障
citrix_connection_failures(days=1)自定义OData查询
citrix_query_raw(
entity="Sessions",
filter="LogOnDuration gt 60000",
select=["SessionKey", "LogOnDuration", "StartDate"],
orderby="LogOnDuration desc",
top=10
)API费率限制
Citrix Monitor服务有以下限制：
- 1个并发查询 每位客户
- 30秒超时 每次查询
- 每页100条记录 （自动处理分页）
客户端以指数回退方式自动重试429（速率限制）响应。
许可证
麻省理工学院