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 命令
• 日志收集: 捕获和存储来自运行进程的日志 (可配置缓冲区大小)
• 按键转发: 将客户端的按键转发到正在运行的进程
• 透明体验: 最终用户看到的命令输出与直接运行它完全相同
• 交互式命令: 适用于像 Expo 这样的交互式 CLI 工具
• MCP 集成: 使用 MCP SDK 构建，便于与 Claude 和其他支持 MCP 的 AI 助手集成

工作原理

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

使用场景

• Expo 开发: 运行 expo start 并在收集日志的同时与之交互
• 构建过程: 监控构建过程并分析日志
• 长时间运行的服务: 监控服务并保留最近的日志历史记录
• 远程命令执行: 从远程客户端执行和监控命令

要求

• Node.js 18+
• TypeScript
• pnpm (推荐) 或 npm

安装

# 安装依赖
pnpm install

# 构建项目
pnpm build

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

# 或者全局安装
pnpm install -g
mcp-command-proxy --prefix "MyServer" --command "expo start"

用法

基本用法

# 使用 CLI
mcp-command-proxy --prefix "ExpoServer" --command "expo start"

# 或者以编程方式
import { createServer } from 'mcp-command-proxy';

const server = await createServer({
  prefix: 'ExpoServer',
  command: 'expo start',
  bufferSize: 500,
  port: 8080
});

// 稍后停止服务器
server.stop();

选项

• --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: 返回进程的当前状态

   • 参数：无

示例

运行 Expo Start

mcp-command-proxy -p "ExpoServer" -c "expo start" -b 500

与 Claude 一起使用

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

开发

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

# 安装依赖
pnpm install

# 构建项目
pnpm build

# 在开发模式下运行
pnpm dev

许可证

MIT