Aci MCP

🚀 ACI模型上下文協議（MCP）服務器

這是一個全面的MCP服務器，可通過APIC REST API對思科ACI（應用中心基礎設施）架構進行配置和管理。它提供了超過35種工具，能滿足對ACI架構的完整管理需求。

🚀 快速開始

本MCP服務器提供了35種以上的工具，用於全面管理ACI架構，主要功能如下：

• 租戶管理：創建、列出、獲取、更新和刪除租戶。
• 應用程序配置文件：管理租戶內的應用程序配置文件。
• 端點組（EPG）：配置和管理端點組。
• 橋接域：創建和管理第2層域。
• VRF：管理虛擬路由和轉發實例。
• 合約：定義和管理安全策略。
• 健康監控：監控架構的健康狀況和故障。
• 節點管理：管理架構節點和接口。

📦 安裝指南

前提條件

• Node.js 18+ 和 npm
• 能夠訪問思科APIC控制器
• 有效的APIC憑證（用戶名/密碼或證書）

安裝步驟

1. 克隆並安裝依賴：

   cd aci-mcp-server
   npm install
   

2. 配置認證信息：

   選項A：使用環境變量

   cp .env.example .env
   # 在.env文件中編輯你的APIC詳細信息
   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
   # 在aci-config.json文件中編輯你的設置
   

   選項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
   # 應該連接到APIC並顯示可用的工具
   

📚 詳細文檔

認證方式

服務器支持兩種認證方式：

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          # 或者 'all'
export ACI_TENANT_FOCUS=production # 專注於特定租戶

💻 使用示例

可用工具

租戶管理（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 - 獲取特定端點組的詳細信息
• create_endpoint_group - 創建新的端點組
• update_endpoint_group - 更新端點組配置
• delete_endpoint_group - 刪除端點組
• get_endpoint_group_stats - 獲取端點組統計信息

橋接域管理（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系統信息