Gst Mcp

gst-mcp

用于 GStreamer 检查和管线开发的 MCP 服务。帮助大模型理解 GStreamer 元素、caps 和管线构建。

安装

从 PyPI 安装（推荐）

# Using uvx (no install needed)
uvx gst-mcp

# Or install globally
uv tool install gst-mcp

# Or with pip
pip install gst-mcp

从源代码安装

git clone https://github.com/wizenink/gst-mcp
cd gst-mcp
uv sync

系统要求

• Python 3.13+
• GStreamer 1.0 及其开发文件
• PyGObject（GStreamer Python 绑定）

在 Arch Linux 上：

sudo pacman -S gstreamer gst-plugins-base gst-plugins-good python-gobject

在 Ubuntu/Debian 上：

sudo apt install gstreamer1.0-tools gstreamer1.0-plugins-base gstreamer1.0-plugins-good python3-gi

在 Claude Code 中使用

添加到 ~/.claude/settings.json：

{
  "mcpServers": {
    "gstreamer": {
      "command": "uvx",
      "args": ["gst-mcp"]
    }
  }
}

或者，如果从源代码安装：

{
  "mcpServers": {
    "gstreamer": {
      "command": "uv",
      "args": ["--directory", "/path/to/gst-mcp", "run", "gst-mcp"]
    }
  }
}

可用工具

注册表检查

• list_elements - 按类别列出元素（source、sink、decoder、encoder、muxer、demuxer、filter、parser）
• get_element_info - 获取元素的详细信息（属性、pad、caps 模板、信号）
• list_plugins - 列出所有已安装的 GStreamer 插件
• get_plugin_info - 获取插件详情及其元素
• search_elements - 按名称、描述或 caps 搜索元素

Caps 与协商

• parse_caps - 将 caps 字符串解析为结构化信息
• check_caps_compatible - 检查两个 caps 是否可以交集
• check_elements_can_link - 根据 pad caps 检查元素是否可以链接
• suggest_converter - 为不兼容的元素推荐转换器元素

管线工具

• validate_pipeline - 验证管线语法并提供错误建议
• run_pipeline - 执行管线（同步运行并设置超时，或异步运行）
• get_pipeline_status - 获取正在运行的管线状态
• stop_pipeline - 停止正在运行的管线
• list_running_pipelines - 列出所有正在运行的管线
• get_pipeline_graph - 生成管线的 DOT 图

文档与示例

• get_examples - 按类别提供管线示例（播放、转码、流媒体、采集、效果、测试、分析）
• fetch_online_docs - 从 GStreamer 网站获取元素文档

示例问题

向 Claude 提问：

• “哪些元素可以解码 H.264 视频？”
• “我可以将 videotestsrc 直接链接到 x264enc 吗？”
• “如何创建将 MP4 转码为 WebM 的管线？”
• “compositor 元素有哪些属性？”
• “请展示 RTMP 流媒体管线的示例”

许可证

MIT