Foreman MCP Server

工头mcp服务器

如何跑步

将VSCode与Copilot一起使用

通过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

如果未提供默认值：

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

配置VSCode

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

运行VSCode客户端

• 按Ctrl+Shift+P
• 选择MCP：列出服务器命令
• 选择领班
• 按启动服务器

在Copilot聊天中使用

• 按Ctrl+Alt+I打开聊天
• 在配置工具中，仅选择MCP工具
• 聊天中可以列出提示，例如/mcp.foreman.basic_hosts_pending_sec_updates_static_report
• 可以通过添加上下文来附加资源。..>MCP资源>资源

使用MCP检查器

与mcp检查器一起使用

1. 以以下方式启动检查器 npx @modelcontextprotocol/inspector
2. 打开 http://localhost:6274 在您的浏览器中
3. 集 Type 向 Streamable HTTP 和 URL 向 http://localhost:8080/mcp

• 或设置 Type 向 SSE 和 URL 向 http://localhost:8080/sse

1. 单击连接

在Linux上使用Claude桌面

注：这是高度实验性的。在运行CentOS Stream 9的虚拟机中测试。

安装

• 遵循安装步骤https://github.com/bsneed/claude-desktop-fedora?tab=readme-ov文件#1 fedora-package-new
• 如果它没有启动，试试\`npm i-g electronic

配置

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

运行Claude客户端

这将启动UI应用程序，登录您的帐户。它将自动启动并连接到MCP服务器。

claude-desktop

• 点击 + 按钮>从工头添加：>从服务器中选择任何提示和资源
• 单击配置按钮从服务器中选择工具