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 服务器运行任何 CLI 命令
• 日志收集：捕获并存储正在运行的进程的日志（可配置缓冲区大小）
• 按键转发：将客户端的按键转发到正在运行的进程
• 透明体验：最终用户看到的命令输出就像直接运行命令一样
• 交互式命令：与 Expo 等交互式 CLI 工具配合使用
• MCP 集成：使用 MCP SDK 构建，可轻松与 Claude 和其他支持 MCP 的 AI 助手集成

工作原理

1. 服务器在伪终端（PTY）中启动指定的命令
2. 所有 stdout/stderr 输出为：
   • 实时传输到客户端
   • 存储在循环缓冲区中（可配置大小，默认300行）
3. 来自客户端的按键被转发到正在运行的进程
4. 该服务器提供以下工具：
   • 查看收集的日志
   • 将按键操作发送给进程
   • 获取进程的当前状态

用例

• Expo Development ：运行expo start并在收集日志时与其交互
• 构建过程：监控构建过程并分析日志
• 长期运行服务：监控服务并保存最近的日志历史记录
• 远程命令执行：执行并监控来自远程客户端的命令

要求

• Node.js 18+
• TypeScript
• pnpm（推荐）或 npm

安装

用法

基本用法

选项

• --prefix, -p ：服务器的名称/前缀（默认值：“CommandProxy”）
• --command, -c ：要运行的命令（必需）
• --buffer-size, -b ：保存在内存中的日志行数（默认值：300）
• --port ：HTTP 服务器端口（默认值：8080）
• --help, -h ：显示帮助

MCP 集成

该服务器实现了以下 MCP 工具：

1. getRecentLogs ：返回缓冲区中最新的日志
   • 参数：
     • limit （可选）：返回的日志数量（默认值：100）
     • types （可选）：要包含的日志类型（stdout、stderr、system）（默认值：全部）
2. sendKeyPress ：向正在运行的进程发送按键消息
   • 参数：
     • key ：要发送的键（例如“enter”，“a”，“1”，“space”）
3. getProcessStatus ：返回进程的当前状态
   • 参数：无

示例

跑步博览会开幕

与 Claude 一起使用

1. 配置 Claude 连接到此 MCP 服务器（SSE 端点： http://localhost:8080/sse ）
2. 要求 Claude 运行 Expo 或其他命令
3. Claude 可以分析日志并帮助解决问题

发展

执照

麻省理工学院