Foreman

foreman-mcp-server

Como executar

Usando VSCode com Copilot

Iniciar o servidor 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

Valores padrão se não fornecidos:

--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"
            }
        }
    },
}

Executar o cliente VSCode

• Pressione Ctrl+Shift+P
• Selecione o comando MCP: List Servers
• Selecione foreman
• Pressione Start Server

Usando no Copilot Chat

• Pressione Ctrl+Alt+I para abrir o chat
• Em Configure Tools, selecione apenas as ferramentas MCP
• Os prompts podem ser listados no chat, por exemplo, /mcp.foreman.basic_hosts_pending_sec_updates_static_report
• Os recursos podem ser anexados via Add Context... > MCP Resources > resource

Usando o MCP Inspector

Para uso com o mcp inspector

1. Inicie o inspector com npx @modelcontextprotocol/inspector
2. Abra http://localhost:6274 no seu navegador
3. Defina Type para Streamable HTTP e URL para http://localhost:8080/mcp

• ou defina Type para SSE e URL para http://localhost:8080/sse

4. Clique em connect

Usando Claude Desktop no Linux

Nota: isto é altamente experimental. Testado em uma máquina virtual rodando CentOS Stream 9.

Instalação

• Siga os passos de instalação https://github.com/bsneed/claude-desktop-fedora?tab=readme-ov-file#1-fedora-package-new
• Se não iniciar, tente `npm i -g electron

Configuração

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

Executar o cliente Claude

Isso iniciará o aplicativo de interface, faça login na sua conta. Ele iniciará e se conectará ao servidor MCP automaticamente.

claude-desktop

• Clique no botão + > Add from foreman: > Selecione qualquer um dos Prompts e Recursos do servidor
• Clique no botão Configuration para selecionar Ferramentas do servidor