Skip to main content
Glama
adamruzicka

foreman-mcp-py

by adamruzicka

foreman-mcp-py

How to run

Using uv locally

# uv run foreman-mcp \
    --foreman-url https://my-foreman-instance.something.somewhere \
    --foreman-username $FOREMAN_USERNAME \
    --foreman-password $FOREMAN_PASSWORD \
    --log-level debug \
    --host localhost \
    --port 8080

Related MCP server: Foreman MCP Server

Using vscode

Example vscode config

# settings.json
{
    "mcp": {
        "servers": {
            "foreman-mcp-py": {
                "type": "sse",
                "url": "http://localhost:8080/mcp/sse",

            }
        }
    },
}

Using container

First, build the container:

podman build -t foreman-mcp .

Now run the container:

podman run -it -p 8080:8080 foreman-mcp --foreman-url https://my-foreman-instance.something.somewhere --foreman-username $FOREMAN_USERNAME --foreman-password $FOREMAN_PASSWORD --log-level debug --port 8080 --host localhost

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    C
    quality
    D
    maintenance
    Enables interaction with Foreman infrastructure management platform through MCP tools, prompts, and resources. Supports querying host information, security updates, and accessing Foreman data via natural language.
    4
    GPL 3.0
  • A
    license
    B
    quality
    C
    maintenance
    Enables interaction with Foreman instances to manage systems through the Model Context Protocol. It provides access to Foreman resources and tools, such as security update reports, directly within AI-powered environments like VSCode and Claude Desktop.
    5
    11
    GPL 3.0
  • A
    license
    A
    quality
    B
    maintenance
    MCP server for managing Proxmox VE clusters — provision VMs and containers, manage snapshots and backups, execute commands, browse storage, and monitor resources through natural language
    34
    94 PyPI
    16
    MIT