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