trackmcp
Back to directory
ofedoren

foreman-mcp-server

View on GitHub

Foreman

0 stars PythonOthers Updated Jul 3, 2025

Documentation

foreman-mcp-server

How to run

Using VSCode with Copilot

Start the server via uv

shell
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:

shell
--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

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

Run VSCode client

    Using in Copilot Chat

      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`

        4) Click connect

        Using Claude Desktop on Linux

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

        Installation

          Configuration

          code
          # ~/.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.

          shell
          claude-desktop

            Frequently asked questions

            What is foreman-mcp-server?

            foreman-mcp-server is Foreman

            How do I install foreman-mcp-server?

            Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

            Is foreman-mcp-server open source?

            Yes — it is hosted on GitHub at https://github.com/ofedoren/foreman-mcp-server.

            Related MCP tools

            Run your own MCP server? See who uses it and what to fix.

            Measure it with TrackMCP