Foreman

Integrate with Foreman to manage hosts and other infrastructure resources.

GitHub

foreman-mcp-server

How to run

Using VSCode with Copilot

Start the server via uv

uv run foreman-mcp-server
--foreman-url https://foreman.example.com
--foreman-username $FOREMAN_USERNAME
--foreman-password $FOREMAN_PASSWORD
--log-level debug
--host localhost
--port 8080 --transport streamable-http

Default values if not provided:

--foreman-url https://$hostname --foreman-username admin --foreman-password changeme --log-level INFO --host '127.0.0.1' --port 8080 --transport streamable-http

Configure VSCode

# settings.json
{
    "mcp": {
        "servers": {
            "foreman": {
                "url": "http://127.0.0.1:8080/mcp/sse"
            }
        }
    },
}

Run VSCode client

  • Press Ctrl+Shift+P
  • Select MCP: List Servers command
  • Select foreman
  • Press Start Server

Using in Copilot Chat

  • Press Ctrl+Alt+I to open the chat
  • In Configure Tools select the MCP tools only
  • Prompts can be listed in the chat, e.g. /mcp.foreman.basic_hosts_pending_sec_updates_static_report
  • Resources can be attached via Add Context... > MCP Resources > resource

Using MCP Inspector

For use with mcp inspector

  1. Start the inspector with npx @modelcontextprotocol/inspector
  2. Open http://localhost:6274 in your browser
  3. Set Type to Streamable HTTP and URL to http://localhost:8080/mcp
  • or set Type to SSE and URL to http://localhost:8080/sse
  1. Click connect

Using Claude Desktop on Linux

Note: this is highly experimental. Tested in a virtual machine running CentOS Stream 9.

Installation

Configuration

# ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "foreman": {
      "command": "uv",
      "args": ["--directory", "/home/$USER/foreman-mcp-server", "run","foreman-mcp-server", "--transport", "stdio"],
    }
  }
}

Run Claude client

This will launch UI application, log in into your account. It will start and connect to the MCP server automatically.

claude-desktop

  • Click + button > Add from foreman: > Select any of Prompts and Resources from the server
  • Click Configuration button to select Tools from the server

Related Servers