MCP Command Proxy

🚀 MCP 命令代理服務器

MCP 命令代理服務器是一個基於 MCP（模型上下文協議）的服務器，它作為命令行界面（CLI）命令的代理，專為 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 輸出都會：
   • 即時流式傳輸到客戶端。
   • 存儲在循環緩衝區中（可配置大小，默認 300 行）。
3. 客戶端的按鍵轉發到運行中的進程。
4. 服務器提供以下工具：
   • 查看收集的日誌。
   • 向進程發送按鍵。
   • 獲取進程的當前狀態。

📦 安裝指南

依賴安裝

# 安裝依賴
pnpm install

# 構建項目
pnpm build

# 直接運行
pnpm start -- --prefix "MyServer" --command "expo start"

# 或全局安裝
pnpm install -g

然後運行：
mcp-command-proxy --install

開發環境搭建

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

# 安裝依賴
pnpm install

# 構建項目
pnpm build

# 運行開發模式
pnpm dev

📚 詳細文檔

使用場景

• Expo 開發：運行expo start並與之交互，同時收集日誌。
• 構建過程：監控構建過程並分析日誌。
• 長期運行的服務：監控服務並保持最近的日誌歷史。
• 遠程命令執行：從遠程客戶端執行和監控命令。

📄 許可證

本項目採用 MIT 許可證。