Cisco ACI MCP Server

ACI Model Context Protocol (MCP) 服务

通过 APIC REST API 配置和管理 Cisco ACI（Application Centric Infrastructure）架构的综合 MCP 服务。

概述

此 MCP 服务提供 35+ 个工具，用于全面管理 ACI 架构，包括：

• 租户管理：创建、列出、获取、更新和删除租户
• 应用配置文件：管理租户中的应用配置文件
• 端点组（EPG）：配置和管理端点组
• 桥接域：创建和管理第 2 层域
• VRF：管理虚拟路由和转发实例
• 合同：定义和管理安全策略
• 运行状况监控：监控架构运行状况和故障
• 节点管理：管理架构节点和接口

安装

先决条件

• Node.js 18+ 和 npm
• 可访问 Cisco APIC 控制器
• 有效的 APIC 凭据（用户名/密码或证书）

设置

1. 克隆并安装：

   cd aci-mcp-server
   npm install
   

2. 配置身份验证：

   选项 A：环境变量

   cp .env.example .env
   # Edit .env with your APIC details
   export ACI_APIC_URL="https://your-apic.domain.com"
   export ACI_USERNAME="admin"
   export ACI_PASSWORD="your_password"
   

   选项 B：配置文件

   cp aci-config.json.example aci-config.json
   # Edit aci-config.json with your settings
   

   选项 C：证书身份验证

   export ACI_APIC_URL="https://your-apic.domain.com"
   export ACI_USERNAME="admin"
   export ACI_CERT_NAME="your-cert-name"
   export ACI_PRIVATE_KEY_PATH="/path/to/private.key"
   

3. 构建服务：

   npm run build
   

4. 测试连接：

   npm start
   # Should connect to APIC and display available tools
   

配置

身份验证方法

此服务支持两种身份验证方法：

1. 用户名/密码：标准 APIC 登录
2. 证书：基于 X.509 证书的身份验证（生产环境推荐）

工具配置

使用 aci-mcp-config.json 配置可用工具：

{
  "serverConfig": {
    "name": "aci",
    "toolSelectionMode": "whitelist",
    "enableAllTools": false,
    "tenantFocus": "production"
  },
  "toolConfiguration": {
    "enabledTools": ["list_tenants", "get_fabric_health", ...],
    "disabledTools": []
  }
}

工具模式：

• core：基本工具（35 个）- 默认
• all：所有可用工具（50+ 个）

环境变量配置：

export ACI_TOOL_MODE=core          # or 'all'
export ACI_TENANT_FOCUS=production # Focus on specific tenant

可用工具

租户管理（5 个工具）

• list_tenants - 列出租户
• get_tenant - 获取指定租户的详细信息
• create_tenant - 创建新租户
• update_tenant - 更新租户配置
• delete_tenant - 删除租户

应用配置文件管理（5 个工具）

• list_application_profiles - 列出应用配置文件
• get_application_profile - 获取指定应用配置文件
• create_application_profile - 创建新的应用配置文件
• update_application_profile - 更新应用配置文件
• delete_application_profile - 删除应用配置文件

端点组管理（6 个工具）

• list_endpoint_groups - 列出端点组
• get_endpoint_group - 获取指定 EPG 的详细信息
• create_endpoint_group - 创建新的 EPG
• update_endpoint_group - 更新 EPG 配置
• delete_endpoint_group - 删除 EPG
• get_endpoint_group_stats - 获取 EPG 统计信息

桥接域管理（5 个工具）

• list_bridge_domains - 列出桥接域
• get_bridge_domain - 获取指定桥接域
• create_bridge_domain - 创建新的桥接域
• update_bridge_domain - 更新桥接域
• delete_bridge_domain - 删除桥接域

VRF 管理（5 个工具）

• list_vrfs - 列出 VRF
• get_vrf - 获取指定 VRF 的详细信息
• create_vrf - 创建新的 VRF
• update_vrf - 更新 VRF 配置
• delete_vrf - 删除 VRF

合同管理（8 个工具）

• list_contracts - 列出合同
• get_contract - 获取合同详细信息
• create_contract - 创建新合同
• update_contract - 更新合同
• delete_contract - 删除合同
• list_filters - 列出过滤器
• create_filter - 创建新过滤器
• delete_filter - 删除过滤器

运行状况与监控（8 个工具）

• get_fabric_health - 获取整体架构运行状况
• list_faults - 列出架构故障
• get_fault_summary - 按严重程度获取故障摘要
• list_nodes - 列出架构节点
• get_node_health - 获取节点运行状况
• list_interfaces - 列出架构接口
• get_interface_stats - 获取接口统计信息
• get_system_info - 获取 APIC 系统信息