Aci MCP

🚀 ACIモデルコンテキストプロトコル (MCP) サーバー

このサーバーは、APIC REST APIを通じてCisco ACI (Application Centric Infrastructure) ファブリックの設定と管理を行う包括的なMCPサーバーです。

🚀 クイックスタート

このMCPサーバーは、ACIファブリックの完全な管理のために35以上のツールを提供します。主な機能には、テナント管理、アプリケーションプロファイル管理、エンドポイントグループ (EPG) 管理などが含まれます。

✨ 主な機能

• テナント管理：テナントの作成、一覧表示、取得、更新、削除
• アプリケーションプロファイル：テナント内のアプリケーションプロファイルの管理
• エンドポイントグループ (EPGs)：エンドポイントグループの設定と管理
• ブリッジドメイン：レイヤー2ドメインの作成と管理
• VRFs：仮想ルーティングおよび転送インスタンスの管理
• コントラクト：セキュリティポリシーの定義と管理
• ヘルスモニタリング：ファブリックの健全性と障害の監視
• ノード管理：ファブリックノードとインターフェースの管理

📦 インストール

前提条件

• Node.js 18+ と npm
• Cisco 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に接続し、利用可能なツールを表示する必要があります
   

📚 ドキュメント

認証方法

サーバーは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          # または '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 - 特定の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システム情報を取得