Intersight MCP

Intersight MCP服务器

MCP（模型上下文协议）服务器，使LLM能够与Cisco Intersight API交互。此服务器将Intersight操作作为LLM应用程序的工具公开。

服务器支持两种配置模式：

• 🛡️ 核心模式（默认）66个用于安全探索的基本只读工具
• 🚀 所有工具模式：199多个具有完整CRUD功能的完整工具集

看 工具配置.md 了解详细的配置选项。

先决条件

• 已安装Node.js 16+
• 使用GitHub Copilot或Claude Desktop的VSCode
• Intersight API凭证（密钥ID+密钥）

1.构建服务器

npm install
npm run build

2.配置LLM客户端

使用GitHub Copilot进行VSCode

1. 打开VSCode设置： Cmd+Shift+P → “首选项：打开用户设置（JSON）”

1. 将此配置添加到您的 settings.json:

{
  "github.copilot.chat.mcp.servers": {
    "intersight": {
      "command": "node",
      "args": ["/path/to/intersight-mcp-server/build/index.js"],
      "env": {
        "INTERSIGHT_API_KEY_ID": "your-api-key-id",
        "INTERSIGHT_API_SECRET_KEY_PATH": "/path/to/SecretKey.txt",
        "INTERSIGHT_BASE_URL": "https://intersight.com/api/v1",
        "INTERSIGHT_TOOL_MODE": "core"
      }
    }
  }
}

1. 重新加载VS代码： Cmd+Shift+P → “开发人员：重新加载窗口”

适用于克劳德桌面

1. 找到您的Claude Desktop配置文件：

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json - Linux： ~/.config/Claude/claude_desktop_config.json

1. 将此配置添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "intersight": {
      "command": "node",
      "args": ["/path/to/intersight-mcp-server/build/index.js"],
      "env": {
        "INTERSIGHT_API_KEY_ID": "your-api-key-id",
        "INTERSIGHT_API_SECRET_KEY_PATH": "/path/to/SecretKey.txt",
        "INTERSIGHT_BASE_URL": "https://intersight.com/api/v1",
        "INTERSIGHT_TOOL_MODE": "core"
      }
    }
  }
}

1. 重新启动Claude Desktop应用程序

3.LLM客户端测试

"Show me all critical alarms"

Intersight Dashboard

📖 有关完整的容器部署指南，请参阅 集装箱_仓库.md

示例用例

监控基础设施

"Show me all servers that are powered on and have critical alarms"

Intersight Dashboard

管理策略

"List all my boot policies and which profiles use each one"

Intersight Dashboard

演示

观看Claude Desktop MCP集成的实际操作：

Claude Desktop MCP Demo

🤖 安全和健康检查代理

Intersight MCP服务器包括 智能安全与健康检查代理 当请求安全或健康检查时，它会自动协调全面的基础设施分析。

代理能力

• 13阶段分析：警报、建议、CVE、固件、硬件、安全态势、合规性和性能
• 智能评分：安全、健康和合规性组件得0-100分
• 基于风险的优先级：分为关键、高、中或低的问题
• 可采取行动的建议：四级指导（即时、短期、中期、长期）
• 执行报告：全面的JSON报告，包含详细的发现和补救步骤

有关详细的代理文档，请参阅 安全\_ EALTH_AGENT.md.

版本历史记录

版本1.0.16

安全和健康检查代理

• ✅ 综合基础设施分析

- createSecurityHealthCheckReport() -智能代理，自动协调13个以上的数据收集阶段 - 分析警报、建议、CVE、固件一致性、硬件健康状况、安全态势、合规性和性能

• ✅ 智能评分系统

- 0-100分：安全、健康、合规 - 加权计算得出的总体基础设施得分 - 问题严重性分类（严重、高、中、低）

• ✅ 可采取行动的建议

- 四级优先建议：立即（现在）、短期（1周）、中期（1个月）、长期（1个季度） - 针对每个已识别问题的具体补救步骤 - 包含关键发现的执行摘要

• ✅ 综合报告章节

- 警报和咨询：严重性跟踪的活动问题 - 安全警告：CVE和字段通知聚合 - 固件分析：版本一致性、更新可用性、EOL跟踪 - 硬件运行状况：组件状态、热/功率监测 - 安全态势：TPM状态、安全启动、许可证合规性 - 合规性：政策合规性、经过认证的操作系统版本、HyperFlex兼容性 - 性能：资源利用率热点（CPU、内存、电源） - 详细问题：具有补救指导的分类问题

• ✅ 生产就绪测试

- 模拟数据测试套件验证所有代理组件 - 成功处理现实的基础设施场景 - 执行时间：综合分析\<1ms

版本1.0.15

工具配置和安全增强

• ✅ 可配置的工具模式

- 核心模式（默认）：66个用于安全探索的基本只读工具 - 所有工具模式：199+完整的工具集，具有完整的CRUD功能 - 环境变量配置： INTERSIGHT_TOOL_MODE=core|all

• ✅ 增强的安全性

- 服务器端工具过滤可防止危险操作的暴露 - 运行时安全检查，并显示明确的错误消息 - 默认安全模式可防止破坏性操作

• ✅ 灵活的配置

- JSON配置文件支持(intersight-mcp-server-config.json) - 环境变量覆盖，便于部署 - 具有不同工具集的多个服务器实例

• ✅ 安全和健康检查代理

- generate_security_health_report -全面的基础设施分析 - 分析警报、建议、CVE、固件、硬件运行状况 - 安全态势评估评分（0-100） - 按优先次序列出的可采取行动的建议

• ✅ 文件和测试

- 全面的工具配置指南 - 验证核心模式安全性和所有工具功能 - 更新了Claude Desktop和VS Code集成示例

版本1.0.14

基于设备的遥测与监测

• ✅ 组件遥测

- get_server_telemetry -服务器指标（CPU、内存、温度、功率） - get_chassis_telemetry -底盘遥测（电源、散热、风扇、PSU） - get_adapter_telemetry -网络适配器统计 - get_top_resources -按指标列出的前N个资源

• ✅ 硬件清单

- list_processor_units -CPU库存和利用率 - list_memory_units -内存模块和使用情况 - list_storage_controllers -存储控制器信息 - list_physical_drives -物理磁盘资源清册 - get_power_statistics -功耗指标 - get_thermal_statistics -温度监测数据

版本1.0.13

Ansible自动化和CVD解决方案集成

• ✅ Ansible示例工具

- get_ansible_examples -三源Ansible自动化资源 - Ansible模块：从插件/模块（Python代码）访问100多个自动化模块 - 示例播放手册：从playbooks目录中工作YAML playbooks - CVD闪存堆栈IMM：来自ucs计算解决方案的经过验证的设计文档 - 源滤波：选择“模块”、“剧本”、“cvd”或“全部”（默认） - 完全自动化覆盖：代码、工作流程和经过验证的设计

版本1.0.12

通过注册表集成增强地形支持

• ✅ 地形工具增强

- get_terraform_examples -现在可以访问Terraform注册表和GitHub模块 - 地形注册表集成：直接链接到register.terraform.io上的官方供应商文档 - 资源文档：获取任何Intersight Terraform资源的资源和数据源文档URL - GitHub模块：使用实际的.tf配置文件访问4个全面的IaC模块 - 双源过滤：选择“注册表”（文档）、“模块”（代码）或“全部”（两者都有） - 完整的地形覆盖：语法文档+工作代码示例

版本1.0.11

Terraform基础设施模块集成

• ✅ 地形模块工具

- get_terraform_examples -从CiscoDevNet GitHub存储库中检索作为代码模块的Terraform基础架构 - 访问4个综合模块：intersight imm（imm策略）、intersight域配置文件、intersight-moids、intersigent-sds - 返回包含计算、网络、管理和存储策略的Terraform配置文件（.tf） - 包括示例变量文件（例如.auto.tfvars），用于快速设置 - 非常适合基础设施自动化和策略即代码部署

版本1.0.10

Python示例和实用程序集成

• ✅ Python SDK示例工具

- get_python_examples -从多个CiscoUcs/CiscoDevNet GitHub存储库中检索Python代码示例 - 访问SDK示例（CiscoUcs/intersight python）-5个基础示例 - 访问Python实用程序（CiscoDevNet/intersight Python-utils）-25多个实用程序脚本 - 按来源筛选：“examples”、“utils”或“all”（默认） - 按主题搜索：服务器、策略、固件、工作流、审计、部署等。 - 返回实际的Python代码以供学习和参考

版本1.0.9

PowerShell示例集成

• ✅ PowerShell SDK示例工具

- get_powershell_examples -从CiscoDevNet GitHub存储库检索PowerShell代码示例 - 访问涵盖所有Intersight操作的89个示例类别 - 返回计算、存储、网络策略等的实际PowerShell代码 - 非常适合学习PowerShell SDK使用模式和最佳实践

版本1.0.8

新增功能：

• ✅ 结构端口管理工具

- list_fabric_ports -列出所有结构互连物理端口 - get_fabric_port -通过MOID获取织物端口详细信息 - list_fabric_uplink_ports -列出所有结构上行链路端口 - list_fabric_server_ports -列出所有结构服务器端口 - list_fabric_port_operations -列出所有结构端口操作

• ✅ 流控制策略工具

- list_fabric_flow_control_policies -列出所有流量控制策略 - get_fabric_flow_control_policy -按MOID获取流量控制策略详细信息 - create_fabric_flow_control_policy -创建流量控制策略（PFC，发送/接收方向） - update_fabric_flow_control_policy -更新流量控制策略 - delete_fabric_flow_control_policy -删除流量控制策略

• ✅ 链接控制策略工具

- list_fabric_link_control_policies -列出所有链接控制策略 - get_fabric_link_control_policy -按MOID获取链路控制策略详细信息 - create_fabric_link_control_policy -创建链接控制策略（UDLD设置） - update_fabric_link_control_policy -更新链接控制策略 - delete_fabric_link_control_policy -删除链接控制策略

• ✅ 链路聚合（LACP）策略工具

- list_fabric_lacp_policies -列出所有LACP政策 - get_fabric_lacp_policy -按MOID获取LACP政策详细信息 - create_fabric_lacp_policy -创建LACP策略（费率、挂起设置） - update_fabric_lacp_policy -更新LACP政策 - delete_fabric_lacp_policy -删除LACP策略

• ✅ 系统QoS工具

- list_fabric_system_qos_policies -列出所有系统QoS策略 - get_fabric_system_qos_policy -按MOID获取系统QoS策略详细信息

• ✅ 多播策略工具

- list_fabric_multicast_policies -列出所有多播策略 - get_fabric_multicast_policy -按MOID获取组播策略详细信息 - create_fabric_multicast_policy -创建多播策略（IGMP侦听、查询器） - update_fabric_multicast_policy -更新多播策略 - delete_fabric_multicast_policy -删除多播策略

• ✅ 可信平台模块（TPM）工具

- list_equipment_tpms -列出所有TPM（可信平台模块）设备 - get_equipment_tpm -通过MOID获取TPM设备详细信息

• ✅ 启动安全工具

- list_boot_device_boot_modes -列出所有引导设备引导模式 - list_boot_device_boot_securities -列出所有启动设备安全设置

• ✅ 本地磁盘策略工具

- list_storage_local_disk_policies -列出所有本地磁盘配置策略 - get_storage_local_disk_policy -按MOID获取本地磁盘策略详细信息 - create_storage_local_disk_policy -创建本地磁盘策略（任意配置、无存储、RAID） - update_storage_local_disk_policy -更新本地磁盘策略 - delete_storage_local_disk_policy -删除本地磁盘策略

• ✅ SD卡策略工具

- list_sdcard_policies -列出所有SD卡策略 - get_sdcard_policy -按MOID获取SD卡政策详细信息 - create_sdcard_policy -创建SD卡策略 - update_sdcard_policy -更新SD卡策略 - delete_sdcard_policy -删除SD卡策略

• ✅ KVM策略工具

- list_kvm_policies -列出所有KVM策略 - get_kvm_policy -按MOID获取KVM策略详细信息 - create_kvm_policy -创建KVM策略（视频加密、最大会话数） - update_kvm_policy -更新KVM策略 - delete_kvm_policy -删除KVM策略

• ✅ 虚拟媒体策略工具

- list_virtual_media_policies -列出所有虚拟媒体策略 - get_virtual_media_policy -按MOID获取虚拟媒体策略详细信息 - create_virtual_media_policy -创建虚拟媒体策略 - update_virtual_media_policy -更新虚拟媒体策略 - delete_virtual_media_policy -删除虚拟媒体策略

• ✅ 设备安全工具

- list_deviceconnector_policies -列出所有设备连接器策略 - get_deviceconnector_policy -按MOID获取设备连接器策略详细信息 - list_certificatemanagement_policies -列出所有证书管理策略 - get_certificatemanagement_policy -按MOID获取证书政策详细信息

• ✅ SNMP策略工具

- list_snmp_policies -列出所有SNMP策略 - get_snmp_policy -按MOID获取SNMP策略详细信息 - create_snmp_policy -创建SNMP策略（端口，启用/禁用） - update_snmp_policy -更新SNMP策略 - delete_snmp_policy -删除SNMP策略

• ✅ Syslog策略工具

- list_syslog_policies -列出所有Syslog策略 - get_syslog_policy -按MOID获取Syslog策略详细信息 - create_syslog_policy -创建Syslog策略 - update_syslog_policy -更新Syslog策略 - delete_syslog_policy -删除Syslog策略

• ✅ NTP策略工具

- list_ntp_policies -列出所有NTP策略 - get_ntp_policy -按MOID获取NTP策略详细信息 - create_ntp_policy -创建NTP策略（服务器、时区） - update_ntp_policy -更新NTP策略 - delete_ntp_policy -删除NTP策略

• ✅ SMTP策略工具

- list_smtp_policies -列出所有SMTP策略 - get_smtp_policy -按MOID获取SMTP策略详细信息 - create_smtp_policy -创建SMTP策略（服务器、端口、发件人） - update_smtp_policy -更新SMTP策略 - delete_smtp_policy -删除SMTP策略

改进：

• 具有流量控制、链路控制和LACP的全面结构网络控制
• 具有TPM、引导安全和KVM的高级硬件安全管理
• 用于监控和通知的完整系统策略管理
• 通过本地磁盘和SD卡策略增强存储管理
• 远程安装的虚拟媒体管理

版本1.0.7

新增功能：

• ✅ 适配器配置工具

- list_adapter_config_policies -列出所有以太网适配器配置策略 - get_adapter_config_policy -按MOID获取适配器策略详细信息 - create_adapter_config_policy -创建新的适配器配置策略 - update_adapter_config_policy -更新现有适配器策略 - delete_adapter_config_policy -删除适配器配置策略

• ✅ 结构端口通道工具

- list_fabric_port_channels -列出所有结构端口通道配置 - get_fabric_port_channel -按MOID获取端口通道详细信息 - create_fabric_port_channel -创建新的结构端口通道 - update_fabric_port_channel -更新现有端口通道 - delete_fabric_port_channel -删除结构端口通道

• ✅ VLAN管理工具

- list_fabric_vlans -列出所有已配置的VLAN - get_fabric_vlan -按MOID获取VLAN详细信息 - create_fabric_vlan -创建新VLAN - update_fabric_vlan -更新现有VLAN - delete_fabric_vlan -删除VLAN

• ✅ VSAN/光纤通道工具

- list_fabric_vsans -列出所有已配置的VSAN - get_fabric_vsan -按MOID获取VSAN详细信息 - create_fabric_vsan -创建新的VSAN - update_fabric_vsan -更新现有VSAN - delete_fabric_vsan -删除VSAN

• ✅ IP池阻止工具

- list_ippool_blocks -列出所有IP地址池块 - get_ippool_block -按MOID获取IP池块详细信息 - create_ippool_block -在池中创建新的IP地址块 - update_ippool_block -更新现有IP池块 - delete_ippool_block -删除IP池块

• ✅ MAC池阻止工具

- list_macpool_blocks -列出所有MAC地址池块 - get_macpool_block -按MOID获取MAC池块详细信息 - create_macpool_block -在池中创建新的MAC地址块 - update_macpool_block -更新现有MAC池块 - delete_macpool_block -删除MAC池块

• ✅ FC池块工具

- list_fcpool_blocks -列出所有光纤通道池块（WWNN/WWPN） - get_fcpool_block -按MOID获取FC池块详细信息 - create_fcpool_block -在池中创建新的FC地址块 - update_fcpool_block -更新现有FC池块 - delete_fcpool_block -删除FC池块

• ✅ 池租赁工具

- list_pool_leases -列出所有池租约（IP/MAC/UID/WWN分配）

改进：

• 完成所有配置管理类别的CRUD操作
• 全面的结构网络管理（端口通道、VLAN、VSAN）
• IP、MAC和光纤通道地址的高级资源池块管理
• 增强的适配器配置策略管理

版本1.0.6

新增功能：

• ✅ 计算库存工具

- list_compute_blades -列出机箱中的所有刀片服务器 - list_compute_rack_units -列出所有机架式服务器 - list_compute_boards -列出所有服务器主板

• ✅ 存储管理工具

- list_storage_virtual_drives -列出所有虚拟驱动器（RAID卷） - list_storage_flex_flash_controllers -列出所有FlexFlash控制器 - list_storage_flex_flash_drives -列出所有FlexFlash物理驱动器

• ✅ 设备和硬件工具

- list_equipment_io_cards -列出机箱中的所有IO卡 - list_equipment_sys_io_ctrls -列出所有系统IO控制器

• ✅ 固件管理工具

- list_firmware_running -列出跨基础架构运行的所有固件版本 - list_firmware_upgrades -列出所有固件升级操作

• ✅ 许可证管理工具

- list_licenses -列出已注册设备的所有许可证信息

• ✅ 工作流自动化工具

- list_workflows -列出所有工作流执行 - get_workflow -获取特定工作流执行的详细信息 - list_workflow_tasks -列出所有工作流任务执行情况

• ✅ PCI和硬件设备工具

- list_pci_devices -列出所有PCI设备（NIC、HBA、GPU等） - list_graphics_cards -列出所有图形卡（GPU）

• ✅ BIOS和固件工具

- list_bios_units -列出所有BIOS/UEFI固件单元

• ✅ 管理控制器工具

- list_management_controllers -列出所有管理控制器（中集、IMC、BMC） - list_management_interfaces -列出所有管理网络接口

改进：

• 包含刀片式和机架式服务器详细信息的全面计算库存
• 增强的存储可见性，包括虚拟驱动器和FlexFlash
• 所有基础架构组件的固件版本跟踪
• 许可证合规性监控
• 工作流执行历史和调试
• PCI设备和GPU清单
• 管理控制器和接口可见性

版本1.0.5

新增功能：

• ✅ 终端和系统拓扑工具

- list_terminal_audit_logs -列出用于合规性和安全监控的终端会话审核日志 - list_top_systems -列出所有具有相关计算资源（刀片和机架单元）的顶级系统 - get_top_system -获取特定系统的详细信息，包括计算资源和网络元素

改进：

• 终端会话审核日志记录以确保安全合规性
• 具有计算资源关联的系统拓扑可见性
• 增强的基础设施映射和资源跟踪

版本1.0.4

新增功能：

• ✅ 硬件兼容性列表（HCL）工具

- list_hcl_operating_systems -列出HCL支持的操作系统 - list_hcl_operating_system_vendors -列出HCL的操作系统供应商 - list_hcl_hyperflex_compatibility -列出HyperFlex软件兼容性信息

• ✅ 技术咨询管理（TAM）工具

- list_tam_advisories -列出所有影响基础设施的技术咨询和现场通知 - get_tam_advisory -获取有关特定咨询的详细信息，包括建议 - list_tam_advisory_instances -列出哪些特定设备受到警告的影响 - list_tam_security_advisories -列出包含CVE信息的安全建议 - get_tam_advisory_count -按严重级别获取咨询计数

改进：

• 完全了解硬件兼容性信息
• 主动监测技术咨询和安全公告
• 直接访问现场通知和受影响的设备跟踪
• 增强的基础设施风险管理能力

版本1.0.3

新增功能：

• ✅ 完整的vNIC管理

- list_vnics -按LAN连接策略列出所有vNIC或筛选器 - get_vnic -获取特定vNIC的详细信息 - update_vnic -更新现有的vNIC配置 - delete_vnic -从LAN连接策略中删除vNIC - list_lan_connectivity_policies -浏览所有局域网连接策略 - get_lan_connectivity_policy -获取详细的局域网连接策略信息 - list_eth_adapter_policies -列出可用的以太网适配器策略 - list_eth_qos_policies -列出可用的以太网QoS策略 - list_eth_network_group_policies -列出所有VLAN组

• ✅ 增强遥测

- get_top_resources -按指标（CPU、内存、功耗、温度）对前N个资源进行排名和识别

改进：

• 完成vNIC管理的CRUD操作
• vNIC配置的全面策略发现
• 能够按父策略列出和筛选资源
• 通过顶级资源识别增强基础设施分析

版本1.0.2

新增功能：

• ✅ 遥测与监测（11种工具）

- get_server_telemetry -全面的服务器指标（CPU、内存、温度、功耗） - get_chassis_telemetry -机箱级遥测（电源、散热、风扇、PSU） - get_adapter_telemetry -网络适配器接口统计 - list_processor_units -跨基础架构的CPU库存和状态 - list_memory_units -内存模块清单 - list_storage_controllers -存储控制器清单 - list_physical_drives -物理磁盘资源清册 - get_power_statistics -服务器和机箱功率指标 - get_thermal_statistics -服务器和机箱的温度数据 - list_fan_modules -风扇模块清单和状态 - list_psu_units -电源设备库存

• ✅ 游泳池管理

- delete_pool -按类型和MOID删除资源池

改进：

• 遥测数据聚合的增强错误处理
• 增加了全面的硬件监控功能
• 全面支持基础设施健康指标

版本1.0.1

新增功能：

• ✅ 网络配置（2个工具）

- create_vnic -创建具有完全策略支持的虚拟网络接口卡 - create_vlan_group -创建VLAN组（以太网网络组策略）

• ✅ 增强的vNIC创建

- 支持以太网适配器策略参考 - 支持QoS策略引用 - 支持以太网网络组策略（VLAN组） - 织物放置（A/B） - MAC池分配 - 故障转移配置 - CDN（一致设备命名）支持

改进：

• 修复了使用正确的ObjectType结构的vNIC策略引用
• 为vNIC创建添加了全面的策略验证
• 支持FI连接和独立网络配置

版本1.0.0

发布： 2025年10月

初始版本功能：

• ✅ 核心基础设施（4个工具）

- 服务器清单和发现 - 机箱和结构互连管理 - 详细的服务器信息检索

• ✅ 报警管理（2个工具）

- 按严重程度列出和过滤警报 - 确认警报

• ✅ 策略管理（8个工具）

- 引导策略（UEFI/传统） - BIOS策略 - 网络/LAN连接策略 - 策略CRUD操作

• ✅ 池管理（7个工具）

- IP、MAC、UUID池创建 - 为光纤通道创建WWNN/WWPN池 - 池更新操作

• ✅ 服务器配置文件（9个工具）

- 配置文件生命周期管理 - 策略和池附件 - 服务器分配和部署

• ✅ 高级搜索

- 对所有Intersight资源的OData查询支持

https://www.cisco.com/c/en/us/support/docs/cloud-systems-management/catalyst-center/223278-harness-the-power-of-mcp-servers.html