LLM交互式Intersight API服务器

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）”

2. 将此配置添加到您的 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"
      }
    }
  }
}

3. 重新加载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

2. 将此配置添加到 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"
      }
    }
  }
}

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

3.LLM客户端测试

"Show me all critical alarms"

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

示例用例

监控基础设施

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

管理策略

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

演示

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

🤖 安全和健康检查代理

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