MCP Server

🚀 MCP サーバー

AIアシスタントに、より効率的にサポートを提供する能力を付与します。このサーバーを使用すると、AIアシスタントは安全にウェブサイトにアクセスし、インターネットを検索できます。また、明確なフィードバックを提供し、問題が発生した場合には有用なエラーメッセージを表示します。

• 🛠️ このサーバーが提供するツールは？
• 🏎️ どのように実行するか？
  • 🐋 Dockerを使用する（推奨）
  • 💻 ローカルで実行する
• 🔌 接続方法
• [📚 詳細情報](# learn-more-about-mcp)
• [📄 ライセンス](# license)

🛠️ このサーバーが提供するツールは？

このサーバーは、2つの主要なツールを提供します。

1. ネットワーク接続（SSE）：サーバーは指定されたネットワークポートで接続を待ち受けます。
2. 直接接続（stdio）：サーバーは標準入出力を介して通信します。

使用シナリオ

🏡 どのように実行するか？

🐋 Dockerを使用する（推奨）

1. Dockerイメージを取得する：

   docker pull mcp-server:latest
   

2. サーバーコンテナを実行する：

   • デフォルト設定で実行：

     docker run --rm -it mcp-server:latest
     

   • ポートと環境変数をカスタマイズする：

     docker run --rm -e SEARXNG_QUERY_URL="http://your-searxng-instance.local:8080" -p 3001:3001 mcp-server:latest
     

💻 ローカルで実行する

1. 仮想環境を作成してアクティブ化する：

   uv venv
   source .venv/bin/activate  # Linux/macOS
   # または
   .venv\Scripts\activate     # Windows
   

2. 依存関係をインストールする：

   uv sync
   

3. 環境変数を設定する：

   export SEARXNG_QUERY_URL="http://your-searxng-instance.local:8080"
   export USER_AGENT="CustomAgent/1.0"
   

4. サーバーを実行する：

   • ネットワークモード（SSE）：

     mcp-server --sse-host 0.0.0.0 --sse-port 3001
     

   • 直接接続モード（stdio）：

     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 環境変数は常に必要です。

🔌 接続方法

サーバーには2つの方法で接続できます。

📚 詳細情報

MCPについて詳しく知るためのリソースを以下に示します。

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

📄 ライセンス

このプロジェクトはGPLv3ライセンスの下で提供されています。詳細については、LICENSE ファイルを参照してください。