redhat-community-ai-tools/igloo-mcp

Igloo MCP Server

An MCP (Model Context Protocol) server that provides AI assistants with search capabilities for Igloo digital workplace instances.

Features

• Full-text search across Igloo communities
• Filter by application types, date ranges, archived content, and parent paths
• Sort results by views or relevance
• Fetch and convert pages to Markdown (single or multiple URLs)
• Search for members by name
• Fetch detailed member profiles and contact information
• Customizable server identity

Prerequisites

• Python 3.12 or higher
• uv package manager
• Access to an Igloo instance with API credentials

Installation & Usage

Quick Start (Direct Execution)

Run directly from GitHub without cloning:

uvx --from git+https://github.com/redhat-community-ai-tools/igloo-mcp igloo-mcp

Configure using environment variables (see Configuration below).

Local Development

Clone and install for local development:

git clone https://github.com/redhat-community-ai-tools/igloo-mcp.git
cd igloo-mcp
uv sync  # Creates .venv/ and installs dependencies
igloo-mcp

Configuration

The server can be configured using:

• Environment variables (recommended for credentials): IGLOO_MCP_* prefix
• CLI arguments: kebab-case options (e.g., --server-name)
• .env file: for local development

Example Configuration

Create a .env file in the project root:

# Required
IGLOO_MCP_COMMUNITY="https://your-igloo-instance.com"
IGLOO_MCP_COMMUNITY_KEY="10"
IGLOO_MCP_APP_ID="your-app-id"
IGLOO_MCP_APP_PASS="your-app-password"
IGLOO_MCP_USERNAME="your-username"
IGLOO_MCP_PASSWORD="your-password"

# Optional
IGLOO_MCP_SERVER_NAME="Your Organization Name"
IGLOO_MCP_LOG_LEVEL="INFO"
IGLOO_MCP_TRANSPORT="stdio"
IGLOO_MCP_PAGE_SIZE=50
IGLOO_MCP_DEFAULT_LIMIT=20

Configuration Parameters

Required:

• IGLOO_MCP_COMMUNITY - Base URL of your Iglo