Juhe MCP Server

🚀 MCP-Proxy 使用指南

MCP-Proxyは、SSEまたはstdioクライアントとして動作するプロキシツールです。このドキュメントでは、MCP-Proxyのインストール方法、コマンドライン引数の使用方法、テスト方法などについて説明します。

🚀 クイックスタート

MCP-Proxyを使用する前に、まずはインストールを行います。以下に、いくつかのインストール方法を紹介します。

📦 インストール

uvツールを使用したインストール

以下のコマンドを使用して、mcp-proxyをインストールします。

uv tool install mcp-proxy

Dockerコンテナでの実行

バージョン0.3.2から、Dockerコンテナでの実行がサポートされています。 イメージを取得し、コンテナを起動します。

docker run -t ghcr.io/sparfenyuk/mcp-proxy:v0.3.2-alpine --help

コンテナイメージの拡張

他の実行可能ファイルを含めるためにイメージを拡張する必要がある場合は、カスタムのDockerfileを作成できます。

Dockerfileの例：

# file: mcp-proxy.Dockerfile

FROM ghcr.io/sparfenyuk/mcp-proxy:latest

# 'uv' パッケージをインストール
RUN python3 -m ensurepip && pip install --no-cache-dir uv

ENV PATH="/usr/local/bin:$PATH" \
    UV_PYTHON_PREFERENCE=only-system

ENTRYPOINT [ "mcp-proxy" ]

Docker Composeの設定

カスタムのDockerfileを使用してサービスを定義します。

docker-compose.yamlの例：

services:
  mcp-proxy-custom:
    build:
      context: .
      dockerfile: mcp-proxy.Dockerfile
    network_mode: host
    restart: unless-stopped
    ports:
      - 8096:8096
    command: "--pass-environment --sse-port=8096 --sse-host 0.0.0.0 uvx mcp-server-fetch"

⚠️ 重要提示

--pass-environment パラメータを設定するのを忘れないでください。そうしないと、「管理インストールまたは検索パスにインタープリターが見つかりません」というエラーが発生します。

📚 ドキュメント

コマンドライン引数

usage: mcp-proxy [-h] [-H KEY VALUE] [-e KEY VALUE] [--pass-environment | --no-pass-environment] [--sse-port SSE_PORT] [--sse-host SSE_HOST]
                 [--allow-origin ALLOW_ORIGIN [ALLOW_ORIGIN ...]]
                 [command_or_url] [args ...]

MCPプロキシを起動し、SSEまたはstdioクライアントとしての2つのモードをサポートします。

位置引数:
  command_or_url        接続するコマンドまたはURL。URLの場合、SSEクライアントを実行します。それ以外の場合は、指定されたコマンドを実行し、stdioクライアントで接続します。詳細については、関連するオプションを参照してください。

オプション:
  -h, --help            このヘルプメッセージを表示して終了します

SSEクライアントオプション:
  -H KEY VALUE, --headers KEY VALUE
                        SSEサーバーにヘッダーを渡します。複数回使用できます。
  
stdioクライアントオプション:
  args                  指定されたコマンドの追加パラメータ
  -e KEY VALUE, --env KEY VALUE
                        サーバーを起動するときに使用する環境変数。複数回使用できます。
  --pass-environment, --no-pass-environment
                        サーバーを起動するときにすべての環境変数を渡します。

SSEサーバーオプション:
  --sse-port SSE_PORT   公開するSSEサーバーのポート。デフォルトはランダムポート
  --sse-host SSE_HOST   公開するSSEサーバーのホスト。デフォルトは127.0.0.1
  --allow-origin ALLOW_ORIGIN [ALLOW_ORIGIN ...]
                        許可するSSEサーバーのオリジン。複数回使用できます。デフォルトではCORSは許可されていません。

例:
  mcp-proxy http://localhost:8080/sse
  mcp-proxy --headers Authorization 'Bearer YOUR_TOKEN' http://localhost:8080/sse
  mcp-proxy -e DEBUG=true my_command.sh

テスト方法

インストールの検証

インストールが成功したかどうかを確認します。

uv tool list | grep mcp-proxy

ツールの更新

最新バージョンに更新します。

uv tool update mcp-proxy

ツールのアンインストール

インストールされたツールをアンインストールします。

uv tool remove mcp-proxy

🔧 その他の注意事項

• 詳細な情報が必要な場合は、元の英語のドキュメントを参照するか、プロジェクトのホームページにアクセスしてください。
• 使用中に問題が発生した場合は、関連する技術資料を参照するか、メンテナンス担当者に問い合わせてください。