返回 MCP 目录
public公开dns本地运行

mcp_shell_server

该项目是一个基于MCP协议的服务器,能够安全高效地执行任意终端命令,支持跨平台操作,并提供系统资源信息。

article

README

🚀 mcp_shell_server

mcp_shell_server是一个安全高效的MCP服务器,可执行任意终端命令,为用户提供便捷的命令执行体验。

🚀 快速开始

本仓库包含在优迪yme课程**“构建、连接、部署:掌握MCP服务器、MCP客户端及强大LLM应用所需工具与资源”**中开发的最终项目。

✨ 主要特性

  • Shell命令执行:支持通过结构化的MCP接口动态执行任何shell命令。
  • 跨平台支持:兼容Linux、macOS以及Windows(通过CMD或PowerShell)。
  • 资源暴露:提供有用的系统级信息,如平台、主机名、shell路径及环境详情。
  • 安全执行:实现了命令限制、输出长度限制和执行超时等防护机制。
  • 易于集成:设计为可轻松嵌入到大型AI代理系统或连接到流行的MCP客户端。

🔧 技术细节

  • Python:作为主要的开发语言,提供了丰富的库和工具,便于实现服务器的各项功能。
  • MCP协议:用于与客户端进行通信,确保数据的可靠传输和交互。
  • 壳/终端接口:实现与系统终端的交互,执行用户输入的命令。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端