项目简介

'mcp-shell-yeah' 是一个基于 Model Context Protocol (MCP) 的标准服务器实现，专门用于帮助AI代理管理本地开发环境中的各种后台Shell进程，例如开发服务器、构建脚本或自动化测试。它解决了AI代理难以可靠地管理需要跨越多个对话持续运行的本地任务的问题。

主要功能点

• 启动和管理Shell： 启动并管理开发服务器、测试运行器、构建脚本等后台进程。
• 跨对话维护状态： 启动的Shell进程状态可在不同的AI对话会话中保持和访问。
• 实时检查状态： 快速获取进程是否正在运行、崩溃或停止的状态。
• 可靠访问日志： 检索任何托管Shell的实时输出和历史日志。
• 停止或重启Shell： 根据需要停止特定进程或所有进程，或方便地重启一个进程。
• 发送输入： 向交互式Shell发送文本输入，模拟用户在终端中的操作。

安装步骤

1. 安装 Node.js： 确保您的系统安装了 Node.js 环境（推荐 v20.x 或更高版本）。
2. 使用 npx 运行： 无需全局安装，您可以直接使用 'npx' 命令来运行最新版本的服务器：

   npx mcp-shell-yeah
   

   运行此命令后，服务器将启动，并通过标准输入输出（stdio）等待MCP客户端的连接。

服务器配置

对于支持MCP的AI客户端（如 Cursor），您需要配置如何启动和连接 'mcp-shell-yeah' 服务器。配置通常是一个JSON对象，指示客户端如何通过标准输入输出与服务器进程通信。

一个典型的客户端MCP服务器配置可能包含以下关键信息：

• 'server name': 服务器的标识名称，例如 '"mcp-shell-yeah"'。
• 'command': 客户端用来启动服务器进程的命令，例如 '"npx"'。
• 'args': 传递给启动命令的参数列表，例如 '["mcp-shell-yeah@latest"]'。

客户端将利用这些信息启动 'npx mcp-shell-yeah@latest' 进程，并建立基于 stdio 的 JSON-RPC 连接来调用服务器提供的工具。

基本使用方法

一旦服务器启动并通过 stdio 连接到MCP客户端，AI代理就可以通过调用服务器暴露的JSON-RPC方法来使用其功能。这些方法通常对应于服务器提供的工具（Tools）。

例如，AI代理可以调用名为 'tools/call' 的JSON-RPC方法，其参数中包含要调用的工具名称（如 'start_shell'、'check_shell'、'list_shells' 等）及其参数。服务器接收请求，执行相应的Shell管理操作，并通过JSON-RPC响应返回结果（例如Shell状态、日志或操作成功/失败信息）。

AI代理根据这些工具调用的结果来理解本地开发环境的状态，并生成相应的回复或执行后续操作。