Command Proxy

🚀 MCP 命令代理服務器

MCP（模型上下文協議）命令代理服務器，作為命令行工具的代理，專為Expo開發量身打造，同時也能適配任何命令行應用程序，為開發者提供便捷高效的命令執行與管理體驗。

🚀 快速開始

如何在Cursor中使用（以Expo為例）

1. 進入你的Expo項目的目錄。
2. 運行 npx mcp-command-proxy --prefix "ExpoServer" --command "expo start" --port 8383。
3. 打開Cursor設置 -> MCP -> 點擊“+添加新的MCP服務器”，如下所示：
   
4. 設置名稱為“ExpoServer”，類型為“SSE”，URL為 http://localhost:8383/sse。
5. 點擊“保存”後，你就可以在Cursor中使用該MCP服務器了。如下所示：
   

⚠️ 重要提示

建議使用 --port 8383 標誌以避免與其他服務器衝突。還可以將以下指令添加到.cursorrules文件中：

你可以使用MCP的getRecentLogs工具獲取Expo服務器的最新日誌。如果需要，可以使用sendKeyPress工具向正在運行的進程發送按鍵。

✨ 主要特性

• 命令代理：通過MCP服務器運行任何CLI命令。
• 日誌收集：捕獲並存儲運行進程的日誌（可配置緩衝區大小）。
• 按鍵轉發：將客戶端的按鍵轉發到運行進程。
• 透明體驗：最終用戶看到的命令輸出與直接運行完全一致。
• 交互式命令支持：適用於交互式CLI工具，如Expo。
• MCP集成：基於MCP SDK構建，便於與Claude和其他MCP啟用的AI助手集成。

🔧 技術細節

工作原理

1. 服務器在偽終端（PTY）中啟動指定的命令。
2. 所有stdout/stderr輸出會被：
   • 即時 streamed 到客戶端。
   • 存儲在環形緩衝區中（可配置大小，默認300行）。
3. 客戶端的按鍵會轉發到運行進程。
4. 服務器提供以下工具：
   • 查看收集的日誌。
   • 向進程發送按鍵。
   • 獲取進程的當前狀態。

📦 安裝指南

需求

• Node.js (版本16及以上)
• npm或 yarn
• 操作系統（Windows、Linux、macOS）

安裝步驟

# 克隆倉庫
git clone https://github.com/hormold/mcp-command-proxy.git
cd mcp-command-proxy

# 安裝依賴
pnpm install

# 構建項目
pnpm build

# 運行
pnpm start

💻 使用示例

基本用法

mcp-command-proxy [選項]

選項

• --version、 -v：輸出包版本。
• --help、 -h：輸出使用幫助。
• --port、 -p：指定服務器端口，默認值為3000。
• --prefix、 -x：指定命令前綴，例如“sudo”。
• --command、 -c：指定要執行的命令。

示例

1. 運行基本服務器：

mcp-command-proxy --port 8080

2. 帶命令前綴運行：

mcp-command-proxy --prefix "sudo" --command "npm start"

高級用法

Expo開發

mcp-command-proxy --command "expo start"

在Claude中使用

claude run expo start

📚 詳細文檔

MCP集成

該實現包含以下MCP工具：

getRecentLogs

獲取最近的日誌條目。

參數

• limit：要返回的最新日誌條目的數量，默認值為10。

sendKeyPress

向正在運行的進程發送按鍵事件。

參數

• key：按下的鍵，例如“ArrowUp”或“Enter”。

開發

# 克隆倉庫
git clone https://github.com/hormold/mcp-command-proxy.git
cd mcp-command-proxy

# 安裝依賴
pnpm install

# 構建項目
pnpm build

# 啟動開發模式
pnpm dev

📄 許可證

MIT