Catalyst Center MCP Server

A Python-based MCP (Model Context Protocol) server for Cisco Catalyst Center (formerly DNA Center) that provides tools for device management, client information retrieval, and network monitoring.

Features

• Secure authentication with Cisco Catalyst Center.
• Device discovery, listing, and detailed information retrieval.
• Site information retrieval, including hierarchy and details.
• Network interface information for specific devices.
• Client listing with comprehensive filtering options.
• Detailed client information retrieval by MAC address.
• Client count retrieval with filtering.
• Helper tool for API-compatible time range conversion.
• Implemented using FastMCP for a robust and extensible MCP server.
• Configuration via .env file for easy setup.

Installation

1. Clone the repository:

git clone https://github.com/richbibby/catalyst-center-mcp.git
cd catalyst-center-mcp

2. Create a virtual environment and activate it:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies:

pip install -r requirements.txt

Configuration

1. Copy the example environment file:

cp .env.example .env

2. Update the .env file with your Catalyst Center credentials:

CCC_HOST=your-catalyst-center-host
CCC_USER=your-username
CCC_PWD=your-password

Usage With Claude Desktop Client

1. Configure Claude Desktop to use this MCP server:

• Open Claude Desktop
• Go to Settings > Developer > Edit Config
• Add the following configuration (adjust paths as needed, see claude_desktop_config.json for an example structure):

{
  "mcpServers": {
    "catalyst-center-mcp": {
      "command": "/path/to/your/venv/bin/fastmcp",
      "args": [
        "run",
        "/path/to/your/catalyst-center-mcp/catalyst-center-mcp.py"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

• Replace /path/to/your/... with the absolute paths relevant to your local environment.
• The PYTHONUNBUFFERED environment variable is recommended for Stdio transport.

2. Restart Claude Desktop

3. Interact with Claude Desktop:

• Ask Claude to perform actions like “Show me the devices in my Cisco Catalyst Center”
• Claude will use the MCP server to authenticate and fetch device information

Usage With VScode

1. Configure VSCode to use this MCP server:

• Open VScode
• Open the command pallet : Command + Shift + P in Visual Studio Code on macOS (or Ctrl + Shift + P on Windows and Linux)
• Type: MCP: Open User Configuration
• Add the following configuration (adjust paths as needed, see claude_desktop_config.json for an example structure):

{
  "servers": {
    "catalyst-center-mcp": {
      "type": "stdio",
      "command": "/path/to/your/venv/bin/fastmcp",
      "args": [