使用说明

项目简介

Podman Desktop Agent 扩展旨在为 Podman Desktop 用户提供便捷的 MCP (Model Context Protocol) 服务器集成方案。该扩展程序作为一个桥梁，在 Podman Desktop 环境中启动和管理独立的 MCP 服务器进程，使得用户可以在容器化的环境中，利用 MCP 协议为大型语言模型 (LLM) 应用提供资源、工具和 Prompt 模板等上下文信息。

主要功能点

MCP 服务器集成与管理: 扩展程序负责下载、安装和启动预编译的 'podman-mcp-server' 二进制文件，并对其生命周期进行管理（启动、停止）。
容器环境上下文服务: MCP 服务器运行在 Podman 容器环境中，能够访问和管理容器相关的资源，例如容器镜像、容器实例等，为 LLM 应用提供丰富的上下文信息。
WebSocket 和 SSE 通信: 扩展程序启动 WebSocket 服务器，并配置 MCP 服务器使用 SSE (Server-Sent Events) 协议，支持 MCP 客户端通过标准的协议与 MCP 服务器进行通信。
可配置的 MCP 端口: 用户可以在 Podman Desktop 的扩展配置中自定义 MCP 服务器的端口号。
状态栏指示器: 扩展程序在 Podman Desktop 状态栏显示 MCP 服务器的运行状态和端口信息。

安装步骤

安装 Podman Desktop: 确保您已经安装并配置了 Podman Desktop 应用程序。
安装扩展: 在 Podman Desktop 的扩展市场中搜索 'podman-desktop-agent-extension' 并安装该扩展。
启用扩展: 安装完成后，在 Podman Desktop 的扩展管理页面启用 'Podman Desktop Agent' 扩展。

服务器配置

MCP 服务器的配置主要通过 Podman Desktop 扩展的设置进行管理。对于 MCP 客户端，您需要配置连接到该 MCP 服务器的信息。以下是一个 MCP 客户端可能的服务器配置示例 (JSON 格式)，请注意，实际配置可能因 MCP 客户端而异，但核心信息是类似的：

{
  "serverName": "Podman Desktop MCP Server",
  "command": "http://localhost:{端口号}/sse",
  "args": [],
  "description": "连接到 Podman Desktop 集成的 MCP 服务器，端口号请参考 Podman Desktop 状态栏中 'MCP Server: {端口号}' 的指示。"
}

配置信息说明:

serverName: MCP 服务器的名称，可以自定义。
command: 重要: MCP 服务器的 SSE 连接地址。您需要将 '{端口号}' 替换为 Podman Desktop 状态栏中 'MCP Server: {端口号}' 显示的实际端口号。该端口号由扩展程序动态分配或用户自定义配置。请务必检查 Podman Desktop 状态栏以获取正确的端口号。协议为 'http'，地址为 'localhost'，路径为 '/sse'。
args: 通常情况下，连接到该 MCP 服务器无需额外的启动参数，因此 'args' 数组为空。
description: 服务器的描述信息，可以自定义。

重要提示:

端口号动态获取: MCP 服务器的端口号由扩展程序自动分配或根据用户配置确定。您需要 从 Podman Desktop 状态栏 (通常位于窗口底部) 查找以 "MCP Server: " 开头的状态指示器，其后显示的数字即为当前 MCP 服务器的端口号。
SSE 地址: MCP 客户端需要配置连接到 MCP 服务器的 SSE (Server-Sent Events) 地址，该地址通常格式为 'http://localhost:{端口号}/sse'，请务必将 '{端口号}' 替换为实际端口号。
服务器二进制文件: 该扩展程序会自动下载和管理 'podman-mcp-server-*' 二进制文件，用户无需手动安装。

基本使用方法

启动 Podman Desktop: 启动 Podman Desktop 应用程序。
查看状态栏: 在 Podman Desktop 状态栏中查看 "MCP Server: {端口号}" 指示器，确认 MCP 服务器已启动并获取端口号。
配置 MCP 客户端: 在您的 MCP 客户端应用程序中，根据上述 "服务器配置" 示例，配置连接到 Podman Desktop MCP 服务器的信息，务必将 'command' 中的 '{端口号}' 替换为状态栏中显示的实际端口号。
连接并使用: 启动 MCP 客户端，连接到配置的 MCP 服务器，即可开始利用 MCP 协议进行上下文交互。

关键词