mcpField
S
Shell Mcp Server

Shell Mcp Server

本地服务
github.com/ZHAN2006开发工具065 周前更新
代码仓库

关于 Shell Mcp Server

Shell Mcp Server 是一个通过 MCP 执行 Shell 命令的服务，面向需要从 MCP 客户端调用命令的场景。它支持 cmd 和 powershell，并可通过 npx 启动。

主要功能

  1. 01执行 Shell 命令
  2. 02支持 cmd 和 powershell
  3. 03可通过 npx 运行

适用场景

  1. 01从 MCP 客户端执行 Shell 命令
  2. 02在 cmd 或 powershell 中运行命令

MCP 相关

它作为 MCP 服务，向客户端提供 Shell 命令执行能力。

#shell-mcp-server#mcp-server#command-execution

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "shell-mcp-server-zhan2006": {
      "command": "npx",
      "args": [
        "-y",
        "shell-mcp-server"
      ]
    }
  }
}
启动命令npx -y shell-mcp-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmshell-mcp-server

工具

1

收录的工具列表 · 更新于 3 周前

参数类型必填说明
commandstring是要执行的Shell命令字符串，例如：- Windows: 'dir C:\' 或 'Get-ChildItem'（PowerShell）- Unix: 'ls -la' 或 'pwd'
shellenum否指定使用的终端类型（仅Windows系统有效）：- cmd: Windows命令提示符（默认）- powershell: PowerShell终端Unix系统会自动使用bash终端，忽略此参数cmd | powershell

README 原文English

来自项目 README

README 暂无中文译文，以下为英文原文；中文介绍见上方。

shell-mcp-server

MCP Server for executing shell commands

快速开始

通过npx直接运行
npx -y shell-mcp-server
作为MCP服务器配置
{
  "mcpServers": {
    "shell-mcp-server": {
      "command": "npx",
      "args": ["-y", "shell-mcp-server"]
    }
  }
}
安装为全局命令
npm install -g shell-mcp-server
shell-mcp-server
作为项目依赖安装
npm install shell-mcp-server

使用方法

直接运行
npx -y shell-mcp-server
# 或安装后
shell-mcp-server
编程方式使用
import { startServer } from 'shell-mcp-server';

startServer({
  port: 3000
});

功能特性

  • 安全执行Shell命令
  • 支持多种终端类型(cmd, powershell)
  • 基于Model Context Protocol (MCP) SDK构建
  • 支持npx一键运行
  • 可作为MCP服务器配置

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。