Back to Home
theforeman icon

foreman-mcp-server

Verified Safe

by theforeman

Overview

A Model Context Protocol (MCP) server that enables Language Models (LLMs) to interact with a Foreman instance for IT automation, reporting, and configuration management.

Installation

Run Command
podman run -it -p 8080:8080 foreman-mcp-server --foreman-url https://my-foreman-instance.something.somewhere --log-level debug --host localhost --port 8080 --transport streamable-http

Environment Variables

  • FOREMAN_URL
  • FOREMAN_USERNAME
  • FOREMAN_PASSWORD
  • PORT
  • HOST
  • FOREMAN_CA_BUNDLE

Security Notes

The `AuthMiddleware`'s `user_map` can grow indefinitely, which is noted as a TODO to consider cleanup mechanisms; this could pose a potential resource exhaustion (DoS) risk. For the `streamable-http` transport, authentication relies on credentials (username and token) passed in request headers, shifting security responsibility for credential handling to the client application. Sensitive headers are sanitized before logging. SSL verification with Foreman is configurable via command-line options or environment variables, including support for custom CA bundles.

Similar Servers

Stats

Interest Score35
Security Score8
Cost ClassMedium
Avg Tokens2000
Stars6
Forks9
Last Update2026-01-12

Tags

ForemanMCPLLM IntegrationIT AutomationAPI Adapter