LM Studio Web Search MCP サーバー

LM Studio に DuckDuckGo ウェブ検索、画像検索、YouTube 動画検索・再生、IPTV チャンネル検索・再生を追加するローカル MCP（Model Context Protocol）サーバーです。

機能

• 7 つの 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 のみ許可します。

• bestvideo*+bestaudio/best 形式で yt-dlp を使用するため、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 から使用:

最初の IPTV チャンネルを mpv で再生して。

クイックスタート

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

macOS における LM Studio の mcp.json の場所:

~/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 に置き換えてください。