Natural language interface for AI agents that enables infrastructure management through the DMTF Redfish API, including queries about servers, network interfaces, and other infrastructure components.

Installation

From Source Code

git clone <repository-url>
cd mcp-redfish
make install
uv run mcp-redfish

Development Setup

git clone <repository-url>
cd mcp-redfish
make dev
uv run mcp-redfish

Configuration

Claude Desktop

{
    "mcpServers": {
        "redfish": {
            "command": "<full_path_uv_command>",
            "args": [
                "--directory",
                "<your_mcp_server_directory>",
                "run",
                "mcp-redfish"
            ],
            "env": {
                "REDFISH_HOSTS": "[{\"address\": \"192.168.1.100\", \"username\": \"admin\", \"password\": \"secret123\"}]",
                "REDFISH_AUTH_METHOD": "session",
                "MCP_TRANSPORT": "stdio",
                "MCP_REDFISH_LOG_LEVEL": "INFO"
            }
        }
    }
}

VS Code

{
  "mcp": {
    "servers": {
      "redfish": {
        "type": "stdio",
        "command": "<full_path_uv_command>",
        "args": [
          "--directory",
          "<your_mcp_server_directory>",
          "run",
          "mcp-redfish"
        ],
        "env": {
          "REDFISH_HOSTS": "[{\"address\": \"192.168.1.100\", \"username\": \"admin\", \"password\": \"secret123\"}]",
          "REDFISH_AUTH_METHOD": "session",
          "MCP_TRANSPORT": "stdio"
        }
      }
    }
  }
}

Available Tools

Tool	Description
list_endpoints	Query Redfish API endpoints configured for the MCP server
get_resource_data	Read data from a specific resource (e.g., System, EthernetInterface, etc.)

Features

• Natural language queries: enables AI agents to request infrastructure component data in natural language
• Seamless MCP integration: works with any MCP client for smooth interaction
• Full Redfish support: wrapper for the Python Redfish library
• Multiple transport mechanisms (stdio, SSE, streamable-http)
• Comprehensive configuration validation
• SSL/TLS support with custom CA certificates
• Automatic endpoint discovery
• Support for basic authentication and session-based authentication

Environment Variables

Required

• REDFISH_HOSTS - JSON array of Redfish endpoint configurations

Optional

• REDFISH_PORT - Default port for Redfish API (used when not specified for a specific host)
• REDFISH_AUTH_METHOD - Authentication method: basic or session
• REDFISH_USERNAME - Default username for authentication
• REDFISH_PASSWORD - Default password for authentication
• REDFISH_SERVER_CA_CERT - Path to CA certificate for server verification
• REDFISH_DISCOVERY_ENABLED - Enable automatic endpoint discovery
• REDFISH_DISCOVERY_INTERVAL - Discovery interval in seconds
• MCP_TRANSPORT - Transport method: stdio, sse, or streamable-http

Usage Examples

Show available infrastructure components

Get ethernet interface data for infrastructure component X

Notes

Supports multiple container runtime environments (Docker/Podman), includes comprehensive end-to-end testing with the DMTF Redfish Interface Emulator, and provides extensive development tooling with more than 42 Makefile targets. Repository: https://github.com/nokia/mcp-redfish