Cisco ACI MCP Server

ACI Model Context Protocol（MCP）サーバー

APIC REST API を通じて Cisco ACI（Application Centric Infrastructure）ファブリックを設定および管理するための、包括的な MCP サーバーです。

概要

この MCP サーバーには、ACI ファブリックを完全に管理するための 35 種類以上のツールが用意されています。内容は次のとおりです。

• テナント管理：テナントの作成、一覧表示、取得、更新、削除
• アプリケーションプロファイル：テナント内のアプリケーションプロファイルの管理
• エンドポイントグループ（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
   

設定

認証方式

このサーバーでは、次の 2 つの認証方式をサポートしています。

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 システム情報を取得