MCP Server

MCPサーバー

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

• 🛠️ このサーバーはどのようなツールを提供していますか?
• 🏎️ どうすれば実行できますか?
  • 🐋 Docker の使用（推奨）
  • 💻 ローカルで実行中
• 🔌 接続方法
• 📚 MCPについて詳しくはこちら
• 📄 ライセンス

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

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

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

🐋 Docker の使用（推奨）

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

1. Dockerをまだインストールしていない場合はインストールしてください
2. 次の内容を含む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 を使用します。

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

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

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

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

💻 ローカルで実行中

1. uvをインストールします (Python 3.13 以上が必要です):
   curl -LsSf https://astral.sh/uv/install.sh | sh

   注意: uvがすでにインストールされている場合は、 uv self updateで更新してください。

2. 仮想環境を作成してアクティブ化します。
   uv venv source .venv/bin/activate # Linux/macOS # or .venv\Scripts\activate # Windows
3. ロックファイルから依存関係をインストールします。
   uv sync
4. 必要な環境変数を設定します。
   # 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"
5. サーバーを実行します。
   # 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 つの方法があります。

📚 MCPについて詳しくはこちら

始めるにあたって、いくつかのリソースを以下に示します。

• MCP仕様
• MCP Python SDK
• MCP サンプルサーバー

📄 ライセンス

このプロジェクトはGPLv3ライセンスです。詳細はLICENSEファイルをご覧ください。