MCPサーバー

AIアシスタントに、より効果的にサポートする力を与えましょう。このサーバーを使えば、AIアシスタントはウェブサイトへのアクセスやウェブ検索を安全に行うことができます。状況に関する明確なフィードバックと、問題発生時の役立つエラーメッセージも表示されます。

🛠️ このサーバーはどのようなツールを提供していますか?

サーバーは、AI アシスタントが現実世界の問題を解決するのに役立つ 2 つの強力なツールを提供します。

道具	何ができるのか
検索	SearXNG を介して Web を検索し、最新情報や特定のリソースを検索したり、計算を実行したりできます。
ウェブ	ウェブサイトにアクセスし、コンテンツを処理します。ページを読みやすくするためにマークダウン形式に変換したり、生のコンテンツを取得したり、リンクを抽出したりできます。

Related MCP server: MCP Python Toolbox

🏎️ どうすれば実行できますか?

🐋 Docker の使用（推奨）

安全性とシンプルさを保つため、サーバーはDockerコンテナ内で実行されます。開始方法は次のとおりです。

Dockerをまだインストールしていない場合はインストールしてください

次の内容を含むdocker-compose.ymlというファイルを作成します。

services:
  mcp-server:
    environment:
      # Required: URL for your SearXNG instance's Search API
      - SEARXNG_QUERY_URL=http://searxng:8080
      # Optional: Configure network mode (SSE) for LibreChat etc.
      - SSE_HOST=0.0.0.0
      - SSE_PORT=8080
      # Optional: Set a custom User-Agent for web requests
      - USER_AGENT=MCP-Server/1.0 (github.com/tcpipuk/mcp-server)
    image: ghcr.io/tcpipuk/mcp-server/server:latest
    ports: # Only needed if using SSE_HOST/SSE_PORT
      - "8080:8080" # Expose port 8080 on host
    restart: unless-stopped
    stop_grace_period: 1s

  # Example SearXNG service (optional, adapt as needed)
  # searxng:
  #   environment:
  #     - SEARXNG_BASE_URL=http://searxng:8080 # Ensure SearXNG knows its own URL
  #   image: searxng/searxng:latest
  #   restart: unless-stopped
  #   volumes:
  #     - ./searxng:/etc/searxng:rw

重要: SearXNG インスタンスの検索 API エンドポイント (通常は/または/searchで終わる) を指すSEARXNG_QUERY_URL環境変数を指定する必要があります。
SSE_HOSTとSSE_PORTを設定すると、ネットワークモード（Server-Sent Events）が有効になります。これは、LibreChat のような複数コンテナ環境で使用する場合に推奨されます。省略した場合、サーバーは標準 I/O を使用します。

docker compose up -dを実行して、サーバーコンテナー (およびオプションで SearXNG) を起動します。

ほとんどの人はこれを次のいずれかで使用します:

Claude Desktop - stdio 経由で直接接続します ( docker-compose.ymlのSSE_HOST / SSE_PORTを省略します)。
LibreChat - SSE 経由でネットワークに接続します。

LibreChat の場合は、これをlibrechat.yamlに追加します ( SSE_PORT=8080と仮定)。

mcpServers:
  mcp-server:
    iconPath: "/path/to/icon.png" # Optional: Custom icon
    label: "MCP Web/Search" # Optional: Custom label shown in UI
    type: sse
    url: http://mcp-server:8080/sse # Adjust host/port if needed

💻 ローカルで実行中

uvをインストールします (Python 3.13 以上が必要です):
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```
注意: uvがすでにインストールされている場合は、 uv self updateで更新してください。

仮想環境を作成してアクティブ化します。

uv venv
source .venv/bin/activate  # Linux/macOS
# or
.venv\Scripts\activate     # Windows

ロックファイルから依存関係をインストールします。
```
uv sync
```

必要な環境変数を設定します。

# Required: URL for your SearXNG instance's Search API
export SEARXNG_QUERY_URL="http://your-searxng-instance.local:8080"
# Optional: Custom User-Agent
export USER_AGENT="CustomAgent/1.0"

サーバーを実行します。

# For network (SSE) mode (e.g., for LibreChat)
mcp-server --sse-host 0.0.0.0 --sse-port 3001

# For direct stdio mode (e.g., for Claude Desktop)
mcp-server

使用可能な引数:

--sse-host : SSEリスニングアドレス（例： 0.0.0.0 ）。SSEモードを有効にします。
--sse-port : SSEリスニングポート（例： 3001 ）。SSEモードを有効にします。
--user-agent : カスタム User-Agent 文字列 ( USER_AGENT環境変数をオーバーライドします)。

注: --sse-hostも--sse-portも指定されていない場合（かつSSE_HOST / SSE_PORT環境変数が設定されていない場合）、サーバーはデフォルトでstdioモードSEARXNG_QUERY_URLなります。SEARXNG_QUERY_URL 環境変数は常に必須です。

🔌 接続方法

サーバーに接続するには、次の 2 つの方法があります。

方法	それが意味するもの	いつ使うか
ネットワーク接続（SSE）	サーバーはネットワークポートで接続をリッスンします。	LibreChat またはその他のネットワーククライアントに最適です。
直接接続（stdio）	サーバーは標準入力/出力を介して直接通信します。	ローカルテストや Claude Desktop に役立ちます。