Foreman

foreman-mcp-server

Cómo ejecutar

Usando VSCode con Copilot

Iniciar el servidor mediante 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

Valores predeterminados si no se proporcionan:

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

Configurar VSCode

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

Ejecutar el cliente de VSCode

• Presione Ctrl+Shift+P
• Seleccione el comando MCP: List Servers
• Seleccione foreman
• Presione Start Server

Usar en Copilot Chat

• Presione Ctrl+Alt+I para abrir el chat
• En Configure Tools seleccione únicamente las herramientas MCP
• Los prompts se pueden listar en el chat, p. ej. /mcp.foreman.basic_hosts_pending_sec_updates_static_report
• Los recursos se pueden adjuntar mediante Add Context... > MCP Resources > resource

Usar MCP Inspector

Para usar con mcp inspector

1. Inicie el inspector con npx @modelcontextprotocol/inspector
2. Abra http://localhost:6274 en su navegador
3. Establezca Type a Streamable HTTP y URL a http://localhost:8080/mcp

• o establezca Type a SSE y URL a http://localhost:8080/sse

4. Haga clic en connect

Usar Claude Desktop en Linux

Nota: esto es altamente experimental. Probado en una máquina virtual que ejecuta CentOS Stream 9.

Instalación

• Siga los pasos de instalación https://github.com/bsneed/claude-desktop-fedora?tab=readme-ov-file#1-fedora-package-new
• Si no se inicia, intente `npm i -g electron

Configuración

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

Ejecutar el cliente de Claude

Esto iniciará la aplicación de interfaz de usuario, inicie sesión en su cuenta. Se iniciará y conectará automáticamente al servidor MCP.

claude-desktop

• Haga clic en el botón + > Add from foreman: > Seleccione cualquiera de los Prompts y Resources del servidor
• Haga clic en el botón Configuration para seleccionar Tools del servidor