Ws MCP

🚀 項目說明

本項目將 MCP 標準輸入輸出服務器包裝到 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

📚 詳細文檔

詳細用法示例

# 使用 fetch 的示例
uvx --refresh ws-mcp --command "uvx mcp-server-fetch" --port 3002

# 使用 wcgw 的示例
## 在 macOS 上
uvx --refresh ws-mcp --command "uvx --from wcgw@latest --python 3.12 wcgw_mcp" --port 3001

## 在 Linux（或在 macOS 上遇到問題時）
cd /tmp
git clone https://github.com/nick1udwig/wcgw.git
cd wcgw
git submodule update --init --recursive
git checkout hf/fix-wcgw-on-ubuntu
cd ..
uvx --refresh ws-mcp --command "uvx --from /tmp/wcgw --with /tmp/wcgw/src/mcp_wcgw --python 3.12 wcgw_mcp" --port 3001

# 使用 Brave 搜索的示例
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

# 或者，使用 .env 文件：
uvx --refresh ws-mcp --env-file path/to/.env --command "npx -y @modelcontextprotocol/server-brave-search" --port 3003

# `--command` 可以多次提供！
# 示例同時服務多個服務器：
uvx --refresh ws-mcp --env-file path/to/.env --command "npx -y @modelcontextprotocol/server-brave-search" --command "uvx mcp-server-fetch" --port 3004

# 服務器也可以指定在遵循 [標準 MCP 格式](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server) 的 `.json` 文件中
uvx --refresh ws-mcp --env-file path/to/.env --config path/to/config.json --port 3005