mcpField
W
ws-mcp

ws-mcp

ローカル
github.com/nick1udwig開発ツール2162 週間前に更新

ws-mcp について

ws-mcp は、stdio 形式の MCP サーバーを WebSocket でラップするツールで、kibitz と組み合わせて使用します。設定ファイルで起動する MCP サーバーを指定でき、ローカルの MCP サーバーへネットワーク経由でアクセスしたい開発者に向いています。

主な機能

  1. 01stdio 形式の MCP サーバーを WebSocket でラップ
  2. 02設定ファイルによる複数サーバーの管理
  3. 03デフォルトで wcgw と fetch を含む
  4. 04ポート番号の指定

活用シーン

  1. 01ローカルの MCP サーバーへ WebSocket でアクセス
  2. 02kibitz 向けの MCP サーバーバックエンドの提供
  3. 03uvx による複数 MCP サーバーの迅速な起動

MCP 対応

本プロジェクトは、stdio 形式の MCP サーバーを接続先のクライアントに WebSocket で公開するプロキシです。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"ws": {
"command": "uvx",
"args": [
"ws-mcp@latest"
]
}
}
}
起動コマンドuvx ws-mcp@latest

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypiws-mcp@latest

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

ws-mcp

MCP の stdio サーバーを WebSocket でラップします。 kibitz で使用します。

クイックスタート

前提条件

uv をインストールします:

curl -LsSf https://astral.sh/uv/install.sh | sh
設定

設定ファイルで、実行する MCP サーバーを指定します。 デフォルトの設定(--config または --command 引数を指定しない場合)には、以下が含まれます:

  • wcgw:一般的なシステム操作とファイル管理用
  • fetch:HTTP リクエスト用

設定ファイルを作成するには:

  1. 設定ファイルを作成します:
    cp sample.config.json config.json
    
  2. 必要に応じて、config.json を編集してサーバーを追加または削除します。
  3. 新しい設定ファイルを使用するには、--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

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。