ws-mcp について
ws-mcp は、stdio 形式の MCP サーバーを WebSocket でラップするツールで、kibitz と組み合わせて使用します。設定ファイルで起動する MCP サーバーを指定でき、ローカルの MCP サーバーへネットワーク経由でアクセスしたい開発者に向いています。
主な機能
- 01stdio 形式の MCP サーバーを WebSocket でラップ
- 02設定ファイルによる複数サーバーの管理
- 03デフォルトで wcgw と fetch を含む
- 04ポート番号の指定
活用シーン
- 01ローカルの MCP サーバーへ WebSocket でアクセス
- 02kibitz 向けの MCP サーバーバックエンドの提供
- 03uvx による複数 MCP サーバーの迅速な起動
MCP 対応
本プロジェクトは、stdio 形式の MCP サーバーを接続先のクライアントに WebSocket で公開するプロキシです。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
ws-mcp
MCP の stdio サーバーを WebSocket でラップします。 kibitz で使用します。
クイックスタート
前提条件
uv をインストールします:
curl -LsSf https://astral.sh/uv/install.sh | sh
設定
設定ファイルで、実行する MCP サーバーを指定します。
デフォルトの設定(--config または --command 引数を指定しない場合)には、以下が含まれます:
設定ファイルを作成するには:
- 設定ファイルを作成します:
cp sample.config.json config.json - 必要に応じて、
config.jsonを編集してサーバーを追加または削除します。 - 新しい設定ファイルを使用するには、
--config path/to/config.jsonを指定して実行します。
ws-mcp の実行
デフォルトの設定ファイル(--config または --command 引数を指定しない場合)とポートを使用する基本的な方法:
uvx --refresh ws-mcp@latest
これにより、設定済みのすべてのサーバーがデフォルトのポート(10125)で起動します。
設定ファイルとポートを指定するには:
uvx --refresh ws-mcp@latest --config path/to/config --port 10125
詳細な使用方法
# Example using fetch
uvx --refresh ws-mcp --command "uvx mcp-server-fetch" --port 3002
# Example using wcgw
uvx --refresh ws-mcp --command "uvx --from wcgw@latest --python 3.12 wcgw_mcp" --port 3001
# Example using Brave search
export BRAVE_API_KEY=YOUR_API_KEY_HERE
uvx --refresh ws-mcp --env BRAVE_API_KEY=$BRAVE_API_KEY --command "npx -y @modelcontextprotocol/server-brave-search" --port 3003
# Or, with a .env file:
uvx --refresh ws-mcp --env-file path/to/.env --command "npx -y @modelcontextprotocol/server-brave-search" --port 3003
# `--command` can be supplied multiple times!
# Example serving multiple servers at once:
uvx --refresh ws-mcp --env-file path/to/.env --command "npx -y @modelcontextprotocol/server-brave-search" --command "uvx mcp-server-fetch" --port 3004
# Servers can also be specified in a `.json` file following [the standard MCP format](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server)
uvx --refresh ws-mcp --env-file path/to/.env --config path/to/config.json --port 3005
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。