MCP Searxng 1g0

🚀 mcp-searxng

mcp-searxngは、SSE（Server-Sent Events）プロトコルに基づいて実装されたMCPサーバーです。主な機能は、SearXNG検索エンジンを通じてウェブ検索とコンテンツ収集を提供することです。ユーザーは、異なる検索エンジンのURLを設定することで、検索機能を拡張することができます。

🚀 クイックスタート

mcp-searxngは、SSE（Server-Sent Events）プロトコルに基づいて実装されたMCPサーバーです。SearXNG検索エンジンを通じてウェブ検索とコンテンツ収集を提供し、ユーザーは異なる検索エンジンのURLを設定することで検索機能を拡張できます。

✨ 主な機能

• SSEプロトコルに基づく長時間接続通信の実装
• SearXNGエンジンを通じたキーワード検索のサポート
• ウェブコンテンツ収集機能の提供
• カスタムSearXNGサービスアドレスのサポート

📦 インストール

プロジェクト構造

mcp-searxng/
├── server.py             # SSEプロトコルに基づくMCPサーバーの実装
├── Dockerfile           # プロジェクトのDocker設定ファイル
└── README.md            # プロジェクトドキュメント

依存関係のインストール

1. Python環境のインストール：

python -m pip install --upgrade pip
pip install "uvicorn>=0.25.0"
pip install "httpx>=0.26.0"

2. Node.jsとnpmのインストール：

# nvmのダウンロードとインストール：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.2/install.sh | bash

# shellでnvmを読み込む：
source ~/.nvm/nvm.sh

# Node.jsバージョン22のインストール：
nvm install 22

# Node.jsとnpmが正常にインストールされたことを確認：
node -v # "v22.14.0"が出力されるはず
npm -v # "10.9.2"が出力されるはず

プロジェクトの実行

1. Dockerを使用してMCPサーバーを起動：

docker build -t mcp-searxng .
docker run -d --env SEARXNG_URL=http://localhost:8888 -p 5488:5488 mcp-searxng

2. コマンドラインで直接実行：

uvicorn server:app --host 0.0.0.0 --port 5488

結果の検証

1. MCP Inspectorのインストールと起動：

npx @modelcontextprotocol/inspector

# ブラウザでhttp://localhost:5173にアクセス

2. MCP Inspectorで以下の操作を行う：
   • 転送タイプとしてSSEを選択
   • MCPサーバーのアドレスを入力：http://localhost:5488/sse
   • 接続をクリックし、接続が成功したことを確認
   • ツールタブに切り替え、「List Tools」ボタンをクリックして、利用可能なツールを確認：
     • web_search：キーワード検索に使用
     • web_url_read：ウェブコンテンツ収集に使用

🔧 技術詳細

なぜSSEを選んだのか

SSE（Server-Sent Events）プロトコルは、サーバーがクライアントにリアルタイムイベントをプッシュできる技術です。従来のポーリングメカニズムと比較して、SSEには以下の利点があります。

1. 長時間接続のサポート：各クライアント接続は長時間維持でき、リソース消費を削減します
2. リアルタイム更新：サーバーは即時にデータをクライアントにプッシュできます
3. 低遅延：データ転送が速く、リアルタイム応答が必要なシーンに適しています

MCPサーバーの設定パラメータ

# server.pyで定義されたデフォルトパラメータ
class ServerConfig:
    def __init__(self):
        self.host = "0.0.0.0"
        self.port = 5488
        self.searxng_url = "http://localhost:8888"

# 起動コマンドの例：
uvicorn server:app --host <your host> --port <your port>

パラメータの説明

💻 使用例

基本的な使用法

# server.pyの核心実装
from fastapi import FastAPI
from starlette.responses import EventStreamResponse

app = FastAPI()

@app.get("/sse")
async def sse_endpoint():
    return EventStreamResponse()

実行スクリーンショット