MCPgee
MCPgee
MCPgeeMCPgee

Cisco ACI

v1.0.0•Cloud Services•stable

A simple MCP (Model Context Protocol) that interacts with Cisco ACI

mcp-server-for-cisco-acimcpai-integration
Share:
10
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Cisco ACI?

Cisco ACI is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to simple mcp (model context protocol) that interacts with cisco aci

A simple MCP (Model Context Protocol) that interacts with Cisco ACI

This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A simple MCP (Model Context Protocol) that interacts with Ci

Use Cases

Interact with Cisco ACI infrastructure through MCP.
datacenter

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedFeb 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx mcp-server-for-cisco-aci

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Cisco ACI

The Cisco ACI MCP Server connects AI assistants to Cisco Application Centric Infrastructure (ACI) via the APIC REST API. It exposes two tools: fetch_apic_class for querying any ACI Managed Object class (fvTenant, topSystem, etc.) and make_aci_backup for triggering an SCP-based configuration backup of the APIC fabric. Tested with Claude Desktop and VS Code Copilot in agent mode.

Prerequisites

  • Python 3.10 or later
  • uv installed (https://docs.astral.sh/uv/) — required to run the MCP server via uv run
  • Access to a Cisco APIC controller with REST API reachable from the server host
  • APIC administrator credentials
  • Git to clone the repository
1

Clone the repository

Clone the MCP_server_for_Cisco_ACI repository and enter the project directory.

git clone https://github.com/datacenter/MCP_server_for_Cisco_ACI.git
cd MCP_server_for_Cisco_ACI
2

Configure APIC credentials in .env

Create or edit the .env file in the app/ directory with your APIC controller IP, username, and password. The auth_manager.py loads these at startup via python-dotenv.

# app/.env
APIC_BASE_URL=https://10.48.168.3
APIC_USERNAME=admin
APIC_PASSWORD=your-apic-password
3

Install the MCP CLI tools

Install the mcp[cli] package so the server can be invoked with uv run mcp run.

uv add "mcp[cli]"
# or
pip install "mcp[cli]"
4

Register with VS Code Copilot

Create a .vscode/mcp.json file in your workspace root with the server configuration. Adjust the path to uv.exe and the main.py location for your system.

{
  "servers": {
    "ciscoApicServer": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--with", "mcp[cli]",
        "mcp", "run",
        "/path/to/MCP_server_for_Cisco_ACI/app/main.py"
      ]
    }
  }
}
5

Register with Claude Desktop

Add the server entry to claude_desktop_config.json for Claude Desktop users.

{
  "mcpServers": {
    "ciscoACI": {
      "command": "uv",
      "args": [
        "run",
        "--with", "mcp[cli]",
        "mcp", "run",
        "/path/to/MCP_server_for_Cisco_ACI/app/main.py"
      ]
    }
  }
}
6

Test with a basic ACI class query

Ask Claude or Copilot to fetch a well-known ACI Managed Object class to confirm connectivity.

# Example prompt:
"Fetch the topSystem class from APIC and show me all nodes"

Cisco ACI Examples

Client configuration

Claude Desktop claude_desktop_config.json for the Cisco ACI MCP server using uv and mcp[cli].

{
  "mcpServers": {
    "ciscoACI": {
      "command": "uv",
      "args": [
        "run",
        "--with", "mcp[cli]",
        "mcp", "run",
        "/home/user/MCP_server_for_Cisco_ACI/app/main.py"
      ]
    }
  }
}

Prompts to try

Example prompts using the fetch_apic_class and make_aci_backup tools.

- "Fetch the fvTenant class from APIC and list all tenants"
- "Show me the topSystem class to see all ACI nodes and their health"
- "Get the fvBD class to list all bridge domains in the fabric"
- "Trigger an ACI configuration backup to SCP server 192.168.10.50 with username backupuser"
- "Query the fvEpg class and show all endpoint groups across all tenants"

Troubleshooting Cisco ACI

Authentication fails with APIC credential errors

Verify that APIC_BASE_URL in app/.env uses https:// and matches the exact IP or hostname of your APIC. Confirm APIC_USERNAME and APIC_PASSWORD are correct. The server uses cookie-based token authentication via the /api/aaaLogin.json endpoint—ensure the APIC REST API is enabled and accessible on port 443.

SSL certificate verification errors connecting to APIC

Cisco APIC typically uses a self-signed certificate. The httpx client in auth_manager.py may need verify=False for lab environments. Review auth_manager.py and add ssl_verify=False to the httpx.AsyncClient initialization if needed (not recommended for production).

make_aci_backup returns an error about SCP destination

Ensure the SCP server is reachable from the APIC controller (not just from the machine running the MCP server). The backup operation is executed by the APIC controller itself—verify that the SCP credentials and remote path exist on the target server and that the APIC has network access to it.

Frequently Asked Questions about Cisco ACI

What is Cisco ACI?

Cisco ACI is a Model Context Protocol (MCP) server that simple mcp (model context protocol) that interacts with cisco aci It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Cisco ACI?

Follow the installation instructions on the Cisco ACI GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Cisco ACI?

Cisco ACI works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Cisco ACI free to use?

Yes, Cisco ACI is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Cisco ACI Alternatives — Similar Cloud Services Servers

Looking for alternatives to Cisco ACI? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.

Open WebUI

★ 138.2k

User-friendly AI Interface (Supports Ollama, OpenAI API, ...)

Anything LLM

★ 60.4k

The all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.

LocalAI

★ 46.4k

LocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.

Nacos

★ 33.0k

an easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.

Xiaozhi ESP32

★ 26.7k

本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.

Gateway

★ 11.8k

A blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.

Browse More Cloud Services MCP Servers

Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Cloud ServicesBrowse All Servers

Quick Config Preview

{ "mcpServers": { "mcp-server-for-cisco-aci": { "command": "npx", "args": ["-y", "mcp-server-for-cisco-aci"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Cisco ACI?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides