LM Studio Web Search MCP 服务器

一个本地 MCP（模型上下文协议）服务器，为 LM Studio 添加 DuckDuckGo 网页搜索、图片搜索、YouTube 视频搜索/播放以及 IPTV 频道搜索/播放功能。

功能简介

• 提供七个 MCP 工具：

  • web_search：文本搜索，返回标题、URL 和摘要

  • image_search：图片搜索，返回直接图片 URL 和缩略图 URL

  • video_search：YouTube 视频搜索，返回缩略图、时长、上传者和观看次数

  • open_video_in_browser：在默认浏览器中打开 YouTube 视频

  • play_video_in_mpv：在 mpv 桌面播放器中播放 YouTube 视频

  • iptv_search：从 iptv-org/iptv 搜索公开可用的 IPTV 频道

  • play_iptv_in_mpv：在 mpv 中播放 IPTV 流

• 无需 API 密钥

• 完全在您的 Mac 上运行

Related MCP server: Universal MCP Server

文件

工具

web_search

通过 DuckDuckGo 进行文本搜索。

• 参数：

  • query（字符串，必填）：搜索词

  • max_results（整数，1-10，默认 5）

image_search

通过 DuckDuckGo 进行图片搜索。

• 参数：

  • query（字符串，必填）：搜索词

  • max_results（整数，1-10，默认 5）

• 返回： Markdown 格式的图片结果。每条结果包含一个 Markdown 图片标签 ![title](image_url) 以及来源页面 URL。

这种格式能让 LM Studio 最有可能在聊天窗口中内联渲染图片。如果 LM Studio 没有内联渲染，您可以点击图片 URL 在浏览器中查看。

video_search

通过 yt-dlp 进行 YouTube 视频搜索。

• 参数：

  • query（字符串，必填）：搜索词

  • max_results（整数，1-10，默认 5）

  • format（字符串，默认 "markdown"）："markdown" 返回显式的 ![title](thumbnail) 图片以及可点击的 YouTube 链接；"plain" 返回纯文本链接；"image" 仅返回干净的缩略图 URL。

• 返回： 默认返回包含 YouTube 缩略图图片和可点击的 Watch: 链接的 Markdown。这能让您最有可能在 LM Studio 中看到预览图片和可用的视频 URL。

您可以这样向模型提问：

帮我找一些关于酸面包烘焙的 YouTube 视频。

或者，在找到视频后打开它：

在浏览器中打开第一个视频。

open_video_in_browser

在您的默认浏览器中打开 YouTube URL。

• 参数：

  • url（字符串，必填）：要打开的 YouTube URL

• 返回： 确认 URL 已打开的 JSON 状态或错误消息。

• 出于安全考虑，仅允许 youtube.com、www.youtube.com、youtu.be 和 m.youtube.com URL。

play_video_in_mpv

在 mpv（一款免费桌面视频播放器）中播放 YouTube URL。

• 参数：

  • url（字符串，必填）：要播放的 YouTube URL

  • size（字符串，默认 "large"）："default"、"large"（1280x720）、"fullscreen"，或自定义几何尺寸，如 "800x600" 或 "50%"

• 返回： 确认 mpv 已启动的 JSON 状态或错误消息。

• 仅允许 YouTube URL。

• 使用 yt-dlp 配合 bestvideo*+bestaudio/best 格式，因此 YouTube 视频将以最高可用质量播放。

• 要求： 必须安装 mpv 并确保其在 PATH 中可用。yt-dlp 已由本项目安装，mpv 会自动使用它。

在 macOS 上安装 mpv：

brew install mpv

在 LM Studio 中使用：

在 mpv 中播放第一个视频。

或指定尺寸：

在 mpv 中全屏播放第一个视频。

mpv 将打开自己的窗口并开始播放 YouTube 视频。

iptv_search

从 iptv-org/iptv 搜索公开可用的 IPTV 频道。

• 参数：

  • query（字符串，必填）：搜索词，与频道标题和类别（group-title）匹配

  • max_results（整数，1-30，默认 10）

• 返回： 包含频道名称、类别、徽标、ID 和可点击流 URL 的 Markdown 结果。

• 结果从 https://iptv-org.github.io/iptv/index.m3u 获取。

您可以这样向模型提问：

在 IPTV 上找新加坡新闻频道。

play_iptv_in_mpv

在 mpv 中播放 IPTV 流 URL。

• 参数：

  • url（字符串，必填）：要播放的 .m3u8 流 URL

  • size（字符串，默认 "large"）："default"、"large"（1280x720）、"fullscreen"，或自定义几何尺寸，如 "800x600" 或 "50%"

• 返回： 确认 mpv 已启动的 JSON 状态或错误消息。

• 要求： 必须安装 mpv。

在 LM Studio 中使用：

在 mpv 中播放第一个 IPTV 频道。

快速开始

1. 安装依赖（如果您是在设置完成后阅读此文档，则已安装）：

   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt

2. 测试服务器：

   source venv/bin/activate
   python test_mcp.py

   或使用官方 MCP 客户端冒烟测试（设置期间已使用）：

   source venv/bin/activate
   python -c "
   from mcp import ClientSession, StdioServerParameters, stdio_client
   import anyio
   params = StdioServerParameters(command='bash', args=['./run.sh'])
   async def main():
       async with stdio_client(params) as (read, write):
           async with ClientSession(read, write) as session:
               await session.initialize()
               print([t.name for t in (await session.list_tools()).tools])
               print((await session.call_tool('web_search', arguments={'query': 'today news', 'max_results': 2})).content[0].text[:500])
   anyio.run(main)
   "

配置 LM Studio

LM Studio 0.4.0+ 支持 MCP 服务器。您可以通过应用内 MCP 编辑器添加此服务器，或直接编辑 mcp.json。

应用内（推荐）

1. 打开 LM Studio

2. 转到 设置 → MCP 服务器

3. 点击 添加服务器

4. 填写：

   • 名称： lmstudio-websearch

   • 传输方式： stdio

   • 命令： bash

   • 参数： /ABSOLUTE/PATH/TO/lmstudio-websearch/run.sh

5. 保存并启用服务器

手动编辑 mcp.json

LM Studio 的 mcp.json 在 macOS 上的位置：

~/Library/Application Support/LM Studio/mcp.json

添加此条目（如果文件不存在则创建）：

{
  "mcpServers": {
    "lmstudio-websearch": {
      "command": "bash",
      "args": [
        "/ABSOLUTE/PATH/TO/lmstudio-websearch/run.sh"
      ]
    }
  }
}

启用设置

请确保在 LM Studio 中启用此设置：

• 设置 → 服务器设置 → 允许从 mcp.json 调用服务器

在聊天中使用

1. 加载支持工具调用的模型。Qwen 3.8 27B 在 LM Studio 中具有原生工具使用支持。

2. 开始新的聊天。

3. 提出需要最新信息的问题，例如：

   今天的最新头条是什么？

4. LM Studio 应调用 web_search 工具，获取结果，并基于结果回答。

故障排除

服务器未在 LM Studio 中列出

• 确认 run.sh 中的路径是绝对路径，且文件可执行（chmod +x run.sh）。

• 添加服务器后重启 LM Studio。

• 通过 开发者 → 日志 检查 LM Studio 日志。

模型不调用工具

• 使用具有原生工具使用支持的模型（Qwen、Llama 3.1/3.2、Mistral）。

• 确保聊天中已启用 工具（右侧面板）。

• 尝试明确要求模型搜索网页。

搜索无结果

• DuckDuckGo 偶尔会阻止自动请求。稍等片刻后重试。

• 检查您的网络连接。

依赖问题

如果您看到导入错误，请重新安装依赖：

source venv/bin/activate
pip install -r requirements.txt

更新搜索后端

要使用不同的文本搜索提供商（Brave、SearXNG、Bing、Google），请编辑 server.py 并将 do_text_search() 替换为您偏好的 API。